

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualize os pipelines de imagens da AMI a partir do AWS CLI
<a name="cli-update-image-pipeline"></a>

Você pode atualizar um pipeline de imagens de AMI usando um arquivo JSON como entrada para o comando **update-image-pipeline** na AWS CLI. Para configurar o arquivo JSON, você deve ter nomes do recurso da Amazon (ARNs) para referenciar os seguintes recursos existentes:
+ Pipeline de imagens a ser atualizado
+ Fórmula da imagem
+ Configuração de infraestrutura
+ Configurações de distribuição

Você pode atualizar um pipeline de imagem da AMI com o **update-image-pipeline** comando da AWS CLI seguinte forma:

**nota**  
O **update-image-pipeline** comando substitui toda a configuração do pipeline. Você deve especificar todas as propriedades necessárias na solicitação de atualização. Inclua todas as propriedades — tanto as propriedades que você deseja alterar quanto as propriedades que devem permanecer as mesmas. As propriedades que você omite são redefinidas para os valores padrão ou são removidas.  
Para evitar a remoção não intencional das configurações existentes, use o **get-image-pipeline** comando para recuperar a configuração atual. Em seguida, modifique somente os campos que você deseja alterar:  

```
aws imagebuilder get-image-pipeline --image-pipeline-arn arn:aws:imagebuilder:{{us-west-2}}:{{123456789012}}:image-pipeline/{{my-pipeline}}
```
Use a saída como base para seu arquivo JSON de solicitação de atualização.

1. 

**Criar um arquivo JSON de entrada da CLI**

   Use a sua ferramenta favorita de edição de arquivos para criar um arquivo JSON com as chaves a seguir, além de valores válidos para seu ambiente. Este exemplo usa um arquivo denominado `create-component.json`:

   ```
   	{
   	"imagePipelineArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-pipeline/{{my-example-pipeline}}",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-example-recipe}}/2019.12.08",
   	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:infrastructure-configuration/{{my-example-infrastructure-configuration}}",
   	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:distribution-configuration/{{my-example-distribution-configuration}}",
   	"imageTestsConfiguration": {
   		"imageTestsEnabled": true,
   		"timeoutMinutes": 120
   	},
   	"schedule": {
   		"scheduleExpression": "cron(0 0 * * MON *)",
   		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
   	},
   	"status": "DISABLED"
   }
   ```
**nota**  
É necessário incluir a notação `file://` no início do caminho do arquivo JSON.
O caminho para o arquivo JSON deve seguir a convenção apropriada para o sistema operacional de base no qual você está executando o comando. Por exemplo, o Windows usa a barra invertida (\\) para se referir ao caminho do diretório, enquanto o Linux e o macOS usam a barra (/).

1. Execute o seguinte comando, usando o arquivo que você criou como entrada.

   ```
   aws imagebuilder update-image-pipeline --cli-input-json file://{{update-image-pipeline.json}}
   ```