D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'Image Builder utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with Image Builder.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `create-component`
L'exemple de code suivant montre comment utiliser`create-component`.
**AWS CLI**
**Pour créer un composant**
L’exemple `create-component` suivant crée un composant qui utilise un fichier de document JSON et fait référence à un document de composant au format YAML qui est chargé dans un compartiment Amazon S3.
```
aws imagebuilder create-component \
--cli-input-json file://create-component.json
```
Contenu de `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"
}
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-component.html)à la section *Référence des AWS CLI commandes*.
### `create-distribution-configuration`
L'exemple de code suivant montre comment utiliser`create-distribution-configuration`.
**AWS CLI**
**Pour créer une configuration de distribution**
L’exemple `create-distribution-configuration` suivant crée une configuration de distribution à l’aide d’un fichier JSON.
```
aws imagebuilder create-distribution-configuration \
--cli-input-json file:/create-distribution-configuration.json
```
Contenu de `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"
]
}
}
}
]
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)à la section *Référence des AWS CLI commandes*.
### `create-image-pipeline`
L'exemple de code suivant montre comment utiliser`create-image-pipeline`.
**AWS CLI**
**Pour créer un pipeline d’images**
L’exemple `create-image-pipeline` suivant crée un pipeline d’images à l’aide d’un fichier JSON.
```
aws imagebuilder create-image-pipeline \
--cli-input-json file://create-image-pipeline.json
```
Contenu de `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"
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-pipeline.html)à la section *Référence des AWS CLI commandes*.
### `create-image-recipe`
L'exemple de code suivant montre comment utiliser`create-image-recipe`.
**AWS CLI**
**Pour créer une recette**
L’exemple `create-image-recipe` suivant crée une recette d’image à l’aide d’un fichier JSON. Les composants sont installés dans l’ordre dans lequel ils sont spécifiés.
```
aws imagebuilder create-image-recipe \
--cli-input-json file://create-image-recipe.json
```
Contenu de `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"
}
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-recipe.html)à la section *Référence des AWS CLI commandes*.
### `create-image`
L'exemple de code suivant montre comment utiliser`create-image`.
**AWS CLI**
**Pour créer une image**
L’exemple `create-image` suivant crée une image.
```
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
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)à la section *Référence des AWS CLI commandes*.
### `create-infrastructure-configuration`
L'exemple de code suivant montre comment utiliser`create-infrastructure-configuration`.
**AWS CLI**
**Pour créer une configuration d’infrastructure**
L’exemple `create-infrastructure-configuration` suivant crée une configuration d’infrastructure à l’aide d’un fichier JSON.
```
aws imagebuilder create-infrastructure-configuration \
--cli-input-json file://create-infrastructure-configuration.json
```
Contenu de `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"
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [CreateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-infrastructure-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-component`
L'exemple de code suivant montre comment utiliser`delete-component`.
**AWS CLI**
**Pour supprimer un composant**
L’exemple `delete-component` suivant supprime une version de build d’un composant en spécifiant son ARN.
```
aws imagebuilder delete-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-component.html)à la section *Référence des AWS CLI commandes*.
### `delete-image-pipeline`
L'exemple de code suivant montre comment utiliser`delete-image-pipeline`.
**AWS CLI**
**Pour supprimer un pipeline d’images**
L’exemple `delete-image-pipeline` suivant supprime un pipeline d’images en spécifiant son ARN.
```
aws imagebuilder delete-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [DeleteImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-pipeline.html)à la section *Référence des AWS CLI commandes*.
### `delete-image-recipe`
L'exemple de code suivant montre comment utiliser`delete-image-recipe`.
**AWS CLI**
**Pour supprimer une recette d’image**
L’exemple `delete-image-recipe` suivant supprime une recette d’image en spécifiant son ARN.
```
aws imagebuilder delete-image-recipe \
--image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [DeleteImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-recipe.html)à la section *Référence des AWS CLI commandes*.
### `delete-image`
L'exemple de code suivant montre comment utiliser`delete-image`.
**AWS CLI**
**Pour supprimer une image**
L’exemple `delete-image` suivant supprime une version de build d’une image en spécifiant son ARN.
```
aws imagebuilder delete-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [DeleteImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image.html)à la section *Référence des AWS CLI commandes*.
### `delete-infrastructure-configuration`
L'exemple de code suivant montre comment utiliser`delete-infrastructure-configuration`.
**AWS CLI**
**Pour supprimer une configuration d’infrastructure**
L’exemple `delete-infrastructure-configuration` suivant supprime un pipeline d’images en spécifiant son ARN.
```
aws imagebuilder delete-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [DeleteInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-infrastructure-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-component-policy`
L'exemple de code suivant montre comment utiliser`get-component-policy`.
**AWS CLI**
**Pour obtenir les détails d’une politique de composant**
L’exemple `get-component-policy` suivant répertorie les détails d’une politique de composant en spécifiant son ARN.
```
aws imagebuilder get-component-policy \
--component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1
```
Sortie :
```
{
"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" ] } ] }"
}
```
*Pour plus d'informations, consultez Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI https://docs.aws.amazon.com/imagebuilder/ latest/userguide/managing < image-builder-cli - .html>`\$1\$1 dans le guide de l'utilisateur d'EC2 Image Builder.*
+ Pour plus de détails sur l'API, reportez-vous [GetComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)à la section *Référence des AWS CLI commandes*.
### `get-component`
L'exemple de code suivant montre comment utiliser`get-component`.
**AWS CLI**
**Pour obtenir des détails sur un composant**
L’exemple `get-component` suivant répertorie les détails d’un composant en spécifiant son ARN.
```
aws imagebuilder get-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)à la section *Référence des AWS CLI commandes*.
### `get-distribution-configuration`
L'exemple de code suivant montre comment utiliser`get-distribution-configuration`.
**AWS CLI**
**Pour obtenir les détails d’une configuration de distribution**
L’exemple `get-distribution-configuration` suivant affiche les détails d’une configuration de distribution en spécifiant son ARN.
```
aws imagebuilder get-distribution-configuration \
--distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-distribution-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-image-pipeline`
L'exemple de code suivant montre comment utiliser`get-image-pipeline`.
**AWS CLI**
**Pour obtenir les détails d’un pipeline d’images**
L’exemple `get-image-pipeline` suivant répertorie les détails d’un pipeline d’images en spécifiant son ARN.
```
aws imagebuilder get-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-pipeline.html)à la section *Référence des AWS CLI commandes*.
### `get-image-policy`
L'exemple de code suivant montre comment utiliser`get-image-policy`.
**AWS CLI**
**Pour obtenir les détails d’une politique d’image**
L’exemple `get-image-policy` suivant répertorie les détails d’une politique d’image en spécifiant son ARN.
```
aws imagebuilder get-image-policy \
--image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1
```
Sortie :
```
{
"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" ] } ] }"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-policy.html)à la section *Référence des AWS CLI commandes*.
### `get-image-recipe-policy`
L'exemple de code suivant montre comment utiliser`get-image-recipe-policy`.
**AWS CLI**
**Pour obtenir les détails d’une politique de recette d’image**
L’exemple `get-image-recipe-policy` suivant répertorie les détails d’une politique de recette d’image en spécifiant son 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
```
Sortie :
```
{
"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" ] } ] }"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-recipe-policy.html)à la section *Référence des AWS CLI commandes*.
### `get-image`
L'exemple de code suivant montre comment utiliser`get-image`.
**AWS CLI**
**Pour obtenir les détails d’une image**
L’exemple `get-image` suivant répertorie les détails d’une image en spécifiant son ARN.
```
aws imagebuilder get-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image.html)à la section *Référence des AWS CLI commandes*.
### `get-infrastructure-configuration`
L'exemple de code suivant montre comment utiliser`get-infrastructure-configuration`.
**AWS CLI**
**Pour obtenir les détails d’une configuration d’infrastructure**
L’exemple `get-infrastructure-configuration` suivant répertorie les détails d’une configuration d’infrastructure en spécifiant son ARN.
```
aws imagebuilder get-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [GetInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-infrastructure-configuration.html)à la section *Référence des AWS CLI commandes*.
### `import-component`
L'exemple de code suivant montre comment utiliser`import-component`.
**AWS CLI**
**Pour importer un composant**
L’exemple `import-component` suivant importe un script préexistant à l’aide d’un fichier JSON.
```
aws imagebuilder import-component \
--cli-input-json file://import-component.json
```
Contenu de `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"
}
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ImportComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-component.html)à la section *Référence des AWS CLI commandes*.
### `list-component-build-versions`
L'exemple de code suivant montre comment utiliser`list-component-build-versions`.
**AWS CLI**
**Pour répertorier les versions de build des composants**
L’exemple `list-component-build-versions` suivant répertorie les versions de build des composants avec une version sémantique spécifique.
```
aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02
```
Sortie :
```
{
"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"
}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListComponentBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)à la section *Référence des AWS CLI commandes*.
### `list-components`
L'exemple de code suivant montre comment utiliser`list-components`.
**AWS CLI**
**Pour répertorier toutes les versions sémantiques des composants**
L’exemple `list-components` suivant répertorie toutes les versions sémantiques des composants auxquelles vous avez accès. Vous pouvez éventuellement filtrer les composants qui vous appartiennent, ceux d’Amazon ou ceux qui ont été partagés avec vous par d’autres comptes.
```
aws imagebuilder list-components
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)à la section *Référence des AWS CLI commandes*.
### `list-distribution-configurations`
L'exemple de code suivant montre comment utiliser`list-distribution-configurations`.
**AWS CLI**
**Pour répertorier les distributions**
L’exemple `list-distribution-configurations` suivant répertorie toutes vos distributions.
```
aws imagebuilder list-distribution-configurations
```
Sortie :
```
{
"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"
}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListDistributionConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-distribution-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-image-build-versions`
L'exemple de code suivant montre comment utiliser`list-image-build-versions`.
**AWS CLI**
**Pour répertorier les versions de build d’images**
L’exemple `list-image-build-versions` suivant répertorie toutes les versions de build d’images avec une version sémantique.
```
aws imagebuilder list-image-build-versions \
--image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListImageBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)à la section *Référence des AWS CLI commandes*.
### `list-image-pipeline-images`
L'exemple de code suivant montre comment utiliser`list-image-pipeline-images`.
**AWS CLI**
**Pour répertorier les images du pipeline d’images**
L’exemple `list-image-pipeline-images` suivant répertorie toutes les images créées par un pipeline d’images spécifique.
```
aws imagebuilder list-image-pipeline-images \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Sortie :
```
{
"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"
}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListImagePipelineImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-pipeline-images.html)à la section *Référence des AWS CLI commandes*.
### `list-image-recipes`
L'exemple de code suivant montre comment utiliser`list-image-recipes`.
**AWS CLI**
**Pour répertorier les recettes d’images**
L’exemple `list-image-recipes` suivant répertorie toutes vos recettes d’images.
```
aws imagebuilder list-image-recipes
```
Sortie :
```
{
"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"
}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListImageRecipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-recipes.html)à la section *Référence des AWS CLI commandes*.
### `list-images`
L'exemple de code suivant montre comment utiliser`list-images`.
**AWS CLI**
**Pour répertorier des images**
L’exemple `list-images` suivant répertorie toutes les versions sémantiques auxquelles vous avez accès.
```
aws imagebuilder list-images
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)à la section *Référence des AWS CLI commandes*.
### `list-infrastructure-configurations`
L'exemple de code suivant montre comment utiliser`list-infrastructure-configurations`.
**AWS CLI**
**Pour répertorier les configurations d’infrastructure**
L’exemple `list-infrastructure-configurations` suivant répertorie toutes vos configurations d’infrastructure.
```
aws imagebuilder list-infrastructure-configurations
```
Sortie :
```
{
"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"
}
}
]
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListInfrastructureConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-infrastructure-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises pour une ressource spécifique**
L’exemple `list-tags-for-resource` suivant répertorie toutes les balises pour une ressource spécifique.
```
aws imagebuilder list-tags-for-resource \
--resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Sortie :
```
{
"tags": {
"KeyName": "KeyValue"
}
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `put-component-policy`
L'exemple de code suivant montre comment utiliser`put-component-policy`.
**AWS CLI**
**Pour appliquer une politique de ressources à un composant**
La commande `put-component-policy` suivante applique une politique de ressources à un composant de build afin de permettre le partage entre comptes des composants de build. Nous vous recommandons d’utiliser la commande `create-resource-share` de l’interface de ligne de commande RAM. Si vous utilisez la commande `put-component-policy` de l’interface de ligne de commande EC2 Image Builder, vous devrez également utiliser la commande `promote-resource-share-create-from-policy` de l’interface de ligne de commande RAM pour que la ressource soit visible par tous les principaux avec lesquels elle est partagée.
```
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" ] } ] }'
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [PutComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-component-policy.html)à la section *Référence des AWS CLI commandes*.
### `put-image-policy`
L'exemple de code suivant montre comment utiliser`put-image-policy`.
**AWS CLI**
**Pour appliquer une politique de ressources à une image**
La commande `put-image-policy` suivante applique une politique de ressources à une image afin de permettre le partage d’images entre comptes. Nous vous recommandons d’utiliser la commande create-resource-share de l’interface de ligne de commande RAM. Si vous utilisez la put-image-policy commande EC2 Image Builder CLI, vous devez également utiliser la promote-resource-share-create commande RAM CLI -from-policy afin que la ressource soit visible par tous les principaux avec lesquels la ressource est partagée.
```
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" ] } ] }'
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [PutImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-policy.html)à la section *Référence des AWS CLI commandes*.
### `put-image-recipe-policy`
L'exemple de code suivant montre comment utiliser`put-image-recipe-policy`.
**AWS CLI**
**Pour appliquer une politique de ressources à une recette d’image**
La commande `put-image-recipe-policy` suivante applique une politique de ressources à une recette d’image afin de permettre le partage des recettes d’image entre comptes. Nous vous recommandons d’utiliser la commande `create-resource-share` de l’interface de ligne de commande RAM. Si vous utilisez la commande `put-image-recipe-policy` de l’interface de ligne de commande EC2 Image Builder, vous devrez également utiliser la commande `promote-resource-share-create-from-policy` de l’interface de ligne de commande RAM pour que la ressource soit visible par tous les principaux avec lesquels elle est partagée.
```
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" ] } ] }'
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [PutImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-recipe-policy.html)à la section *Référence des AWS CLI commandes*.
### `start-image-pipeline-execution`
L'exemple de code suivant montre comment utiliser`start-image-pipeline-execution`.
**AWS CLI**
**Pour démarrer un pipeline d’images manuellement**
L’exemple `start-image-pipeline-execution` suivant démarre manuellement un pipeline d’images.
```
aws imagebuilder start-image-pipeline-execution \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [StartImagePipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour baliser une ressource**
L’exemple `tag-resource` suivant ajoute et balise une ressource dans EC2 Image Builder à l’aide d’un fichier JSON.
```
aws imagebuilder tag-resource \
--cli-input-json file://tag-resource.json
```
Contenu de `tag-resource.json` :
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tags": {
"KeyName: "KeyValue"
}
}
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer une balise d’une ressource**
L’exemple `untag-resource` suivant supprime une balise d’une ressource à l’aide d’un fichier JSON.
```
aws imagebuilder untag-resource \
--cli-input-json file://tag-resource.json
```
Contenu de `untag-resource.json` :
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tagKeys": [
"KeyName"
]
}
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-distribution-configuration`
L'exemple de code suivant montre comment utiliser`update-distribution-configuration`.
**AWS CLI**
**Pour mettre à jour une configuration de distribution**
L’exemple `update-distribution-configuration` suivant met à jour une configuration de distribution à l’aide d’un fichier JSON.
```
aws imagebuilder update-distribution-configuration \
--cli-input-json file://update-distribution-configuration.json
```
Contenu de `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}}"
}
}
]
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [UpdateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-image-pipeline`
L'exemple de code suivant montre comment utiliser`update-image-pipeline`.
**AWS CLI**
**Pour mettre à jour un pipeline d’images**
L’exemple `update-image-pipeline` suivant met à jour un pipeline d’images à l’aide d’un fichier JSON.
```
aws imagebuilder update-image-pipeline \
--cli-input-json file://update-image-pipeline.json
```
Contenu de `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"
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [UpdateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html)à la section *Référence des AWS CLI commandes*.
### `update-infrastructure-configuration`
L'exemple de code suivant montre comment utiliser`update-infrastructure-configuration`.
**AWS CLI**
**Pour mettre à jour une configuration d’infrastructure**
L’exemple `update-infrastructure-configuration` suivant met à jour une configuration d’infrastructure à l’aide d’un fichier JSON.
```
aws imagebuilder update-infrastructure-configuration \
--cli-input-json file:/update-infrastructure-configuration.json
```
Contenu de `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"
}
```
Sortie :
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Pour plus d'informations, consultez la section [Configuration et gestion d'un pipeline d'images EC2 Image Builder à l'aide de la AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) dans *le guide de l'utilisateur d'EC2 Image* Builder.
+ Pour plus de détails sur l'API, reportez-vous [UpdateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html)à la section *Référence des AWS CLI commandes*.