# Exemplos do Image Builder usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Image Builder.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-component`
O código de exemplo a seguir mostra como usar `create-component`.
**AWS CLI**
**Criar um componente**
O exemplo `create-component` a seguir cria um componente que usa um arquivo de documento JSON e faz referência a um documento de componente no formato YAML carregado em um bucket do Amazon S3.
```
aws imagebuilder create-component \
--cli-input-json file://create-component.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-component.html) na *Referência de comandos da AWS CLI*.
### `create-distribution-configuration`
O código de exemplo a seguir mostra como usar `create-distribution-configuration`.
**AWS CLI**
**Criar uma configuração de distribuição**
O exemplo `create-distribution-configuration` a seguir cria uma configuração de distribuição usando um arquivo JSON.
```
aws imagebuilder create-distribution-configuration \
--cli-input-json file:/create-distribution-configuration.json
```
Conteúdo 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"
]
}
}
}
]
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html) na *Referência de comandos da AWS CLI*.
### `create-image-pipeline`
O código de exemplo a seguir mostra como usar `create-image-pipeline`.
**AWS CLI**
**Criar um pipeline de imagens**
O exemplo `create-image-pipeline` a seguir cria um pipeline de imagens usando um arquivo JSON.
```
aws imagebuilder create-image-pipeline \
--cli-input-json file://create-image-pipeline.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-pipeline.html) na *Referência de comandos da AWS CLI*.
### `create-image-recipe`
O código de exemplo a seguir mostra como usar `create-image-recipe`.
**AWS CLI**
**Criar uma fórmula**
O exemplo `create-image-recipe` a seguir cria uma fórmula de imagem usando um arquivo JSON. Os componentes são instalados na ordem em que estão especificados.
```
aws imagebuilder create-image-recipe \
--cli-input-json file://create-image-recipe.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-recipe.html) na *Referência de comandos da AWS CLI*.
### `create-image`
O código de exemplo a seguir mostra como usar `create-image`.
**AWS CLI**
**Criar uma imagem**
O exemplo `create-image` a seguir cria uma imagem.
```
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
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) na *Referência de comandos da AWS CLI*.
### `create-infrastructure-configuration`
O código de exemplo a seguir mostra como usar `create-infrastructure-configuration`.
**AWS CLI**
**Criar uma configuração de infraestrutura**
O exemplo `create-infrastructure-configuration` a seguir cria uma configuração de infraestrutura usando um arquivo JSON.
```
aws imagebuilder create-infrastructure-configuration \
--cli-input-json file://create-infrastructure-configuration.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [CreateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-infrastructure-configuration.html) na *Referência de comandos da AWS CLI*.
### `delete-component`
O código de exemplo a seguir mostra como usar `delete-component`.
**AWS CLI**
**Excluir um componente**
O exemplo `delete-component` a seguir exclui uma versão de compilação de componente especificando seu ARN.
```
aws imagebuilder delete-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-component.html) na * Referência do comando da AWS CLI*.
### `delete-image-pipeline`
O código de exemplo a seguir mostra como usar `delete-image-pipeline`.
**AWS CLI**
**Excluir um pipeline de imagens**
O exemplo `delete-image-pipeline` a seguir exclui um pipeline de imagens especificando seu ARN.
```
aws imagebuilder delete-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [DeleteImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-pipeline.html) na *Referência de comandos da AWS CLI*.
### `delete-image-recipe`
O código de exemplo a seguir mostra como usar `delete-image-recipe`.
**AWS CLI**
**Excluir uma fórmula de imagem**
O exemplo `delete-image-recipe` a seguir mostra como excluir uma fórmula de imagem especificando seu ARN.
```
aws imagebuilder delete-image-recipe \
--image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [DeleteImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-recipe.html) na *Referência de comandos da AWS CLI*.
### `delete-image`
O código de exemplo a seguir mostra como usar `delete-image`.
**AWS CLI**
**Excluir uma imagem**
O exemplo `delete-image` a seguir exclui uma versão de criação de imagem especificando seu ARN.
```
aws imagebuilder delete-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [DeleteImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image.html) na *Referência de comandos da AWS CLI*.
### `delete-infrastructure-configuration`
O código de exemplo a seguir mostra como usar `delete-infrastructure-configuration`.
**AWS CLI**
**Excluir uma configuração de infraestrutura**
O exemplo `delete-infrastructure-configuration` a seguir exclui um pipeline de imagens especificando seu ARN.
```
aws imagebuilder delete-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [DeleteInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-infrastructure-configuration.html) na *Referência de comandos da AWS CLI*.
### `get-component-policy`
O código de exemplo a seguir mostra como usar `get-component-policy`.
**AWS CLI**
**Obter detalhes da política de componentes**
O exemplo `get-component-policy` a seguir lista os detalhes de uma política de componente especificando seu ARN.
```
aws imagebuilder get-component-policy \
--component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1
```
Resultado:
```
{
"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" ] } ] }"
}
```
Para obter mais informações, consulte Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI `\$1\$1 no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html) na *Referência de comandos da AWS CLI*.
### `get-component`
O código de exemplo a seguir mostra como usar `get-component`.
**AWS CLI**
**Obter detalhes do componente**
O exemplo `get-component` a seguir lista os detalhes de um componente especificando seu ARN.
```
aws imagebuilder get-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1
```
Resultado:
```
{
"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": {}
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html) na * Referência do comando da AWS CLI*.
### `get-distribution-configuration`
O código de exemplo a seguir mostra como usar `get-distribution-configuration`.
**AWS CLI**
**Obter os detalhes de uma configuração de distribuição**
O exemplo `get-distribution-configuration` a seguir exibe os detalhes de uma configuração de distribuição especificando seu ARN.
```
aws imagebuilder get-distribution-configuration \
--distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution
```
Resultado:
```
{
"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": {}
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-distribution-configuration.html) na *Referência de comandos da AWS CLI*.
### `get-image-pipeline`
O código de exemplo a seguir mostra como usar `get-image-pipeline`.
**AWS CLI**
**Obter detalhes do pipeline de imagens**
O exemplo `get-image-pipeline` a seguir mostra como excluir um pipeline de imagens especificando seu ARN.
```
aws imagebuilder get-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Resultado:
```
{
"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": {}
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-pipeline.html) na *Referência de comandos da AWS CLI*.
### `get-image-policy`
O código de exemplo a seguir mostra como usar `get-image-policy`.
**AWS CLI**
**Obter detalhes da política de imagens**
O exemplo `get-image-policy` a seguir lista os detalhes de uma política de imagem especificando seu ARN.
```
aws imagebuilder get-image-policy \
--image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1
```
Resultado:
```
{
"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" ] } ] }"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-policy.html) na *Referência de comandos da AWS CLI*.
### `get-image-recipe-policy`
O código de exemplo a seguir mostra como usar `get-image-recipe-policy`.
**AWS CLI**
**Obter detalhes da política de fórmula de imagem**
O exemplo `get-image-recipe-policy` a seguir lista os detalhes de uma política de fórmula de imagem especificando seu 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
```
Resultado:
```
{
"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" ] } ] }"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-recipe-policy.html) na *Referência de comandos da AWS CLI*.
### `get-image`
O código de exemplo a seguir mostra como usar `get-image`.
**AWS CLI**
**Obter detalhes da imagem**
O exemplo `get-image` a seguir lista os detalhes de uma imagem especificando seu ARN.
```
aws imagebuilder get-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1
```
Resultado:
```
{
"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": {}
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image.html) na *Referência de comandos da AWS CLI*.
### `get-infrastructure-configuration`
O código de exemplo a seguir mostra como usar `get-infrastructure-configuration`.
**AWS CLI**
**Obter detalhes da configuração de infraestrutura**
O exemplo `get-infrastructure-configuration` a seguir mostra como excluir um recurso de configuração de infraestrutura especificando seu ARN.
```
aws imagebuilder get-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Resultado:
```
{
"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": {}
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [GetInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-infrastructure-configuration.html) na *Referência de comandos da AWS CLI*.
### `import-component`
O código de exemplo a seguir mostra como usar `import-component`.
**AWS CLI**
**Importar um componente**
O exemplo `import-component` a seguir importa um script preexistente usando um arquivo JSON.
```
aws imagebuilder import-component \
--cli-input-json file://import-component.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ImportComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-component.html) na *Referência de comandos da AWS CLI*.
### `list-component-build-versions`
O código de exemplo a seguir mostra como usar `list-component-build-versions`.
**AWS CLI**
**Listar versões de compilação do componente**
O exemplo `list-component-build-versions` a seguir lista as versões de compilação de componentes com uma versão semântica específica.
```
aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02
```
Resultado:
```
{
"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"
}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListComponentBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html) na *Referência de comandos da AWS CLI*.
### `list-components`
O código de exemplo a seguir mostra como usar `list-components`.
**AWS CLI**
**Listar todas as versões semânticas do componente**
O exemplo `list-components` a seguir lista todas as versões semânticas do componente às quais você tem acesso. Como opção, é possível definir se deseja listar componentes de sua propriedade, da Amazon ou que foram compartilhados com você por outras contas.
```
aws imagebuilder list-components
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html) na * Referência do comando da AWS CLI*.
### `list-distribution-configurations`
O código de exemplo a seguir mostra como usar `list-distribution-configurations`.
**AWS CLI**
**Listar distribuições**
O exemplo `list-distribution-configurations` a seguir lista todas as suas distribuições.
```
aws imagebuilder list-distribution-configurations
```
Resultado:
```
{
"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"
}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListDistributionConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-distribution-configurations.html) na *Referência de comandos da AWS CLI*.
### `list-image-build-versions`
O código de exemplo a seguir mostra como usar `list-image-build-versions`.
**AWS CLI**
**Listar versões de criação de imagem**
O exemplo `list-image-build-versions` a seguir lista todas as versões de criação de imagem com uma versão semântica.
```
aws imagebuilder list-image-build-versions \
--image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03
```
Resultado:
```
{
"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": {}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListImageBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html) na *Referência de comandos da AWS CLI*.
### `list-image-pipeline-images`
O código de exemplo a seguir mostra como usar `list-image-pipeline-images`.
**AWS CLI**
**Listar imagens do pipeline de imagens**
O exemplo `list-image-pipeline-images` a seguir lista todas as imagens que foram criadas por um pipeline de imagens específico.
```
aws imagebuilder list-image-pipeline-images \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Resultado:
```
{
"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"
}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListImagePipelineImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-pipeline-images.html) na *Referência de comandos da AWS CLI*.
### `list-image-recipes`
O código de exemplo a seguir mostra como usar `list-image-recipes`.
**AWS CLI**
**Listar fórmulas de imagem**
O exemplo `list-image-recipes` a seguir lista todas as suas fórmulas de imagem.
```
aws imagebuilder list-image-recipes
```
Resultado:
```
{
"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"
}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListImageRecipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-recipes.html) na *Referência de comandos da AWS CLI*.
### `list-images`
O código de exemplo a seguir mostra como usar `list-images`.
**AWS CLI**
**Listar imagens**
O exemplo `list-images` a seguir lista todas as versões semânticas às quais você tem acesso.
```
aws imagebuilder list-images
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Consulte detalhes da API em [ListImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) na *Referência de comandos da AWS CLI*.
### `list-infrastructure-configurations`
O código de exemplo a seguir mostra como usar `list-infrastructure-configurations`.
**AWS CLI**
**Listar as configurações de infraestrutura**
O exemplo `list-infrastructure-configurations` a seguir lista todas as suas configurações de infraestrutura.
```
aws imagebuilder list-infrastructure-configurations
```
Resultado:
```
{
"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"
}
}
]
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [ListInfrastructureConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-infrastructure-configurations.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Visualizar uma lista de marcações para um recurso da específico**
O exemplo `list-tags-for-resource` a seguir lista todas as marcações para um recurso da específico.
```
aws imagebuilder list-tags-for-resource \
--resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Resultado:
```
{
"tags": {
"KeyName": "KeyValue"
}
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `put-component-policy`
O código de exemplo a seguir mostra como usar `put-component-policy`.
**AWS CLI**
**Aplicar uma política de recursos a um componente**
O comando `put-component-policy` a seguir aplica uma política de recursos a um componente de criação para permitir o compartilhamento entre contas de componentes de criação. Recomendamos o uso do comando RAM CLI `create-resource-share`. Se você usar o comando EC2 Image Builder CLI `put-component-policy`, também deverá usar o comando RAM CLI `promote-resource-share-create-from-policy` para que o recurso fique visível para todas as entidades principais com as quais o recurso é compartilhado.
```
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" ] } ] }'
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [PutComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-component-policy.html) na *Referência de comandos da AWS CLI*.
### `put-image-policy`
O código de exemplo a seguir mostra como usar `put-image-policy`.
**AWS CLI**
**Aplicar uma política de recursos a uma imagem**
O comando `put-image-policy` a seguir aplica uma política de recursos a uma imagem para permitir o compartilhamento entre contas de imagens. Recomendamos o uso do comando RAM CLI create-resource-share. Se você usar o comando put-image-policy da CLI do EC2 Image Builder, também deverá usar o comando RAM CLI promote-resource-share-create-from-policy para que o recurso fique visível para todas as entidades principais com as quais o recurso é compartilhado.
```
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" ] } ] }'
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [PutImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-policy.html) na *Referência de comandos da AWS CLI*.
### `put-image-recipe-policy`
O código de exemplo a seguir mostra como usar `put-image-recipe-policy`.
**AWS CLI**
**Aplicar uma política de recursos a uma fórmula de imagem**
O comando `put-image-recipe-policy` a seguir aplica uma política de recursos a uma fórmula de imagem para permitir o compartilhamento entre contas de fórmulas de imagem. Recomendamos o uso do comando RAM CLI `create-resource-share`. Se você usar o comando EC2 Image Builder CLI `put-image-recipe-policy`, também deverá usar o comando RAM CLI `promote-resource-share-create-from-policy` para que o recurso fique visível para todas as entidades principais com as quais o recurso é compartilhado.
```
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" ] } ] }'
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [PutImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-recipe-policy.html) na *Referência de comandos da AWS CLI*.
### `start-image-pipeline-execution`
O código de exemplo a seguir mostra como usar `start-image-pipeline-execution`.
**AWS CLI**
**Iniciar um pipeline de imagens manualmente**
O exemplo `start-image-pipeline-execution` a seguir inicia manualmente um pipeline de imagens.
```
aws imagebuilder start-image-pipeline-execution \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [StartImagePipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como marcar um recurso**
O exemplo `tag-resource` a seguir adiciona e marca um recurso ao EC2 Image Builder usando um arquivo JSON.
```
aws imagebuilder tag-resource \
--cli-input-json file://tag-resource.json
```
Conteúdo de `tag-resource.json`:
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tags": {
"KeyName: "KeyValue"
}
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de um recurso**
O exemplo `untag-resource` a seguir remove uma marcação de um recurso usando um arquivo JSON.
```
aws imagebuilder untag-resource \
--cli-input-json file://tag-resource.json
```
Conteúdo de `untag-resource.json`:
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tagKeys": [
"KeyName"
]
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-distribution-configuration`
O código de exemplo a seguir mostra como usar `update-distribution-configuration`.
**AWS CLI**
**Atualizar configuração de distribuição**
O exemplo `update-distribution-configuration` a seguir atualiza uma configuração de distribuição usando um arquivo JSON.
```
aws imagebuilder update-distribution-configuration \
--cli-input-json file://update-distribution-configuration.json
```
Conteúdo 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}}"
}
}
]
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [UpdateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html) na *Referência de comandos da AWS CLI*.
### `update-image-pipeline`
O código de exemplo a seguir mostra como usar `update-image-pipeline`.
**AWS CLI**
**Criar um pipeline de imagens**
O exemplo `update-image-pipeline` a seguir atualiza um pipeline de imagens usando um arquivo JSON.
```
aws imagebuilder update-image-pipeline \
--cli-input-json file://update-image-pipeline.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ Para ver detalhes da API, consulte [UpdateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html) na *Referência de comandos da AWS CLI*.
### `update-infrastructure-configuration`
O código de exemplo a seguir mostra como usar `update-infrastructure-configuration`.
**AWS CLI**
**Atualizar uma configuração de infraestrutura**
O exemplo `update-infrastructure-configuration` a seguir atualiza uma configuração de infraestrutura usando um arquivo JSON.
```
aws imagebuilder update-infrastructure-configuration \
--cli-input-json file:/update-infrastructure-configuration.json
```
Conteúdo 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"
}
```
Resultado:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando a AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) no *Guia do usuário do EC2 Image Builder*.
+ *Para ver detalhes da API, consulte [UpdateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html) na Referência de comandos da AWS CLI*.