

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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á.

# Usar `CreateLaunchConfiguration` com uma CLI
<a name="auto-scaling_example_auto-scaling_CreateLaunchConfiguration_section"></a>

Os exemplos de código a seguir mostram como usar o `CreateLaunchConfiguration`.

------
#### [ CLI ]

**AWS CLI**  
**Exemplo 1: criar uma configuração de execução**  
Este exemplo cria uma configuração de inicialização simples.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Criar uma configuração de execução](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 2: criar uma configuração de inicialização com um grupo de segurança, um par de chaves e um script de bootstrapping**  
Este exemplo cria uma configuração de execução com um grupo de segurança, um par de chaves e um script de bootstrapping contido nos dados do usuário.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --security-groups {{sg-eb2af88example}} \
    --key-name {{my-key-pair}} \
    --user-data {{file://myuserdata.txt}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Criar uma configuração de execução](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 3: criar uma configuração de inicialização com um perfil do IAM**  
Este exemplo cria uma configuração de execução com o nome do perfil de instância de um perfil do IAM.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --iam-instance-profile {{my-autoscaling-role}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Função do IAM para aplicações que são executadas em instâncias do Amazon EC2](https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 4: habilitar o monitoramento detalhado em uma configuração de execução**  
Este exemplo cria uma configuração de lançamento com o monitoramento detalhado do EC2 ativado, que envia métricas do EC2 CloudWatch em períodos de 1 minuto.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --instance-monitoring {{Enabled=true}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Configurando o monitoramento de instâncias do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/enable-as-instance-metrics.html) na *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 5: criar uma configuração de execução para instâncias spot**  
Este exemplo cria uma configuração de execução que usa instâncias spot como a única opção de compra.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --spot-price {{"0.50"}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Solicitar instâncias spot](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 6: criar uma configuração de execução usando uma instância do EC2**  
Este exemplo cria uma configuração de execução com base nos atributos de uma instância existente. Ele substitui a locação de localização e determina se um endereço IP público é definido, incluindo as opções `--placement-tenancy` e `--no-associate-public-ip-address`.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc-from-instance}} \
    --instance-id {{i-0123a456700123456}} \
    --instance-type {{m5.large}} \
    --no-associate-public-ip-address \
    --placement-tenancy {{dedicated}}
```
Este comando não produz saída.  
Para obter mais informações, consulte [Criação de uma configuração de execução usando uma instância do EC2](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.  
**Exemplo 7: criar uma configuração de execução com um mapeamento de dispositivos de blocos para um volume do Amazon EBS**  
Este exemplo cria uma configuração de execução com um mapeamento de dispositivos de blocos para um volume `gp3` do Amazon EBS com o nome do dispositivo `/dev/sdh` e um tamanho de volume de 20.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --block-device-mappings '{{[{"DeviceName":"/dev/sdh","Ebs":{"VolumeSize":20,"VolumeType":"gp3"}}]}}'
```
Este comando não produz saída.  
Para obter mais informações, consulte [EBS](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_Ebs.html) na *Referência da API do Amazon EC2 Auto Scaling*.  
*Para obter informações sobre a sintaxe para citar valores de parâmetros formatados em JSON, consulte [Usando aspas com cadeias de caracteres na CLI AWS no Guia do usuário da interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) de linha de comando.AWS *  
**Exemplo 8: criar uma configuração de execução com um mapeamento de dispositivos de blocos para um volume de armazenamento de instância**  
Este exemplo cria uma configuração de execução com `ephemeral1` como volume de armazenamento de instância com o nome do dispositivo `/dev/sdc`.  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --block-device-mappings '{{[{"DeviceName":"/dev/sdc","VirtualName":"ephemeral1"}]}}'
```
Este comando não produz saída.  
Para obter mais informações, consulte a [BlockDeviceMapping](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_BlockDeviceMapping.html)Referência da API *Amazon EC2 Auto Scaling*.  
*Para obter informações sobre a sintaxe para citar valores de parâmetros formatados em JSON, consulte [Usando aspas com cadeias de caracteres na CLI AWS no Guia do usuário da interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) de linha de comando.AWS *  
**Exemplo 9: criar uma configuração de execução e impedir que um dispositivo de blocos se conecte no momento da execução**  
Este exemplo cria uma configuração de execução que suprime um dispositivo de blocos especificado pelo mapeamento de dispositivos de blocos da AMI (por exemplo, `/dev/sdf`).  

```
aws autoscaling create-launch-configuration \
    --launch-configuration-name {{my-lc}} \
    --image-id {{ami-04d5cc9b88example}} \
    --instance-type {{m5.large}} \
    --block-device-mappings '{{[{"DeviceName":"/dev/sdf","NoDevice":""}]}}'
```
Este comando não produz saída.  
Para obter mais informações, consulte a [BlockDeviceMapping](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_BlockDeviceMapping.html)Referência da API *Amazon EC2 Auto Scaling*.  
*Para obter informações sobre a sintaxe para citar valores de parâmetros formatados em JSON, consulte [Usando aspas com cadeias de caracteres na CLI AWS no Guia do usuário da interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) de linha de comando.AWS *  
+  Para obter detalhes da API, consulte [CreateLaunchConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-launch-configuration.html)na *Referência de AWS CLI Comandos*. 

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: Este exemplo cria uma configuração de inicialização chamada “my-lc”. As instâncias do EC2 iniciadas por grupos do Auto Scaling que usam essa configuração de inicialização usam o tipo de instância, a AMI, o grupo de segurança e o perfil do IAM especificados.**  

```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+  Para obter detalhes da API, consulte [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo cria uma configuração de inicialização chamada “my-lc”. As instâncias do EC2 iniciadas por grupos do Auto Scaling que usam essa configuração de inicialização usam o tipo de instância, a AMI, o grupo de segurança e o perfil do IAM especificados.**  

```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+  Para obter detalhes da API, consulte [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------