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 Os exemplos de código a seguir mostram como usar o `CreateLaunchConfiguration`. ------ #### [ CLI ] **AWS CLI** **Exemplo 1: Saiba como 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: Para criar uma configuração de inicialização com um grupo de segurança, um key pair e um script de inicialização** Este exemplo cria uma configuração de inicialização com um grupo de segurança, um key pair e um script de inicialização 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)em *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)*. ------ Para obter uma lista completa dos guias do desenvolvedor do AWS SDK e exemplos de código, consulte[Usando esse serviço com um AWS SDK](sdk-general-information-section.md). Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.