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. # Utilisation de `AllocateHosts` avec une CLI Les exemples de code suivants illustrent comment utiliser `AllocateHosts`. ------ #### [ CLI ] **AWS CLI** **Exemple 1 : pour allouer un Hôte dédié** L’exemple `allocate-hosts` suivant alloue un seul hôte dédié dans la zone de disponibilité `eu-west-1a`, sur lequel vous pouvez lancer des instances `m5.large`. Par défaut, l’hôte dédié accepte uniquement les lancements d’instances cibles et ne prend pas en charge la récupération de l’hôte. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --quantity 1 ``` Sortie : ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` **Exemple 2 : pour allouer un hôte dédié avec le placement automatique et la récupération de l’hôte activés** L’exemple `allocate-hosts` suivant alloue un seul hôte dédié dans la zone de disponibilité `eu-west-1a` avec le placement automatique et la récupération de l’hôte activés. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --auto-placement on \ --host-recovery on \ --quantity 1 ``` Sortie : ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` **Exemple 3 : pour allouer un hôte dédié avec des balises** L’exemple `allocate-hosts` suivant alloue un seul hôte dédié et applique une balise avec une clé nommée `purpose` et une valeur `production`. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --quantity 1 \ --tag-specifications 'ResourceType=dedicated-host,Tags={Key=purpose,Value=production}' ``` Sortie : ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` Pour plus d’informations, consultez [Allocation d’un hôte dédié](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-allocating.html) dans le *Guide de l’utilisateur Amazon EC2*. + Pour plus de détails sur l'API, reportez-vous [AllocateHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/allocate-hosts.html)à la section *Référence des AWS CLI commandes*. ------ #### [ PowerShell ] **Outils pour PowerShell V4** **Exemple 1 : cet exemple alloue un hôte dédié à votre compte pour le type d’instance et la zone de disponibilité donnés** ``` New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1 ``` **Sortie** : ``` h-01e23f4cd567890f3 ``` + Pour plus de détails sur l'API, reportez-vous [AllocateHosts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. **Outils pour PowerShell V5** **Exemple 1 : cet exemple alloue un hôte dédié à votre compte pour le type d’instance et la zone de disponibilité donnés** ``` New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1 ``` **Sortie** : ``` h-01e23f4cd567890f3 ``` + Pour plus de détails sur l'API, reportez-vous [AllocateHosts](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ------ Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Création de EC2 ressources Amazon à l'aide d'un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.