

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.

# Spécifier les options d’UC pour une instance Amazon EC2
<a name="instance-specify-cpu-options"></a>

Vous pouvez spécifier les options d’UC pendant et après le lancement de l’instance.

**Topics**
+ [Désactiver le multithreading simultané](#cpu-options-disable-simultaneous-multithreading)
+ [Spécifiez un nombre personnalisé de vCPU au lancement](#cpu-options-customize-vCPUs-launch)
+ [Spécifier un nombre personnalisé de vCPU dans un modèle de lancement](#cpu-options-customize-vCPUs-launch-template)
+ [Modifier les options d’UC pour votre instance EC2](#change-vCPUs-after-launch)

## Désactiver le multithreading simultané
<a name="cpu-options-disable-simultaneous-multithreading"></a>

Pour désactiver le multithreading simultané (SMT), également appelé hyperthreading, spécifiez 1 thread par cœur.

------
#### [ Console ]

**Désactiver SMT pendant le lancement d’une instance**

1. Suivez la procédure [Lancez une instance EC2 à l’aide de l’assistant de lancement d’instance de la console](ec2-launch-instance-wizard.md) et configurez votre instance selon vos besoins.

1. Développez **Informations avancées** et cochez la case **Spécifier les options du processeur**.

1. Sous **Core count (Nombre de cœurs)**, choisissez le nombre de cœurs d’UC requis. Dans cet exemple, pour spécifier le nombre de cœurs d’UC par défaut pour une instance `r5.4xlarge`, choisissez `8`.

1. Pour désactiver le multithreading, sous **Threads per core (Threads par cœur)**, sélectionnez **1**.

1. Dans le panneau **Summary** (Résumé), vérifiez la configuration de votre instance, puis choisissez **Launch instance** (Lancer l’instance). Pour de plus amples informations, veuillez consulter [Lancez une instance EC2 à l’aide de l’assistant de lancement d’instance de la console](ec2-launch-instance-wizard.md).

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

**Désactiver SMT pendant le lancement d’une instance**  
Utilisez la AWS CLI commande [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) et spécifiez la valeur `1` for `ThreadsPerCore` pour le `--cpu-options` paramètre. Pour `CoreCount`, spécifiez le nombre de cœurs d’UC. Dans cet exemple, pour spécifier le nombre de cœurs d’UC par défaut pour une instance `r7i.4xlarge`, spécifiez la valeur `8`.

```
aws ec2 run-instances \
    --image-id {{ami-0abcdef1234567890}} \
    --instance-type {{r7i.4xlarge}} \
    --cpu-options "CoreCount={{8}},ThreadsPerCore={{1}}" \
    --key-name {{my-key-pair}}
```

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

**Désactiver SMT pendant le lancement d’une instance**  
Utilisez la [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html)commande et spécifiez la valeur `1` for `ThreadsPerCore` pour le `-CpuOptions` paramètre. Pour `CoreCount`, spécifiez le nombre de cœurs d’UC. Dans cet exemple, pour spécifier le nombre de cœurs d’UC par défaut pour une instance `r7i.4xlarge`, spécifiez la valeur `8`.

```
New-EC2Instance `
    -ImageId '{{ami-0abcdef1234567890}}' `
    -InstanceType '{{r7i.4xlarge}}' `
    -CpuOptions @{CoreCount={{8}}; ThreadsPerCore={{1}}} `
    -KeyName '{{my-key-pair}}'
```

------

**Note**  
Pour désactiver SMT pour une instance existante, suivez le processus indiqué dans [Modifier les options d’UC pour votre instance EC2](#change-vCPUs-after-launch) et modifiez le nombre de threads exécutés par cœur en`1`.

## Spécifiez un nombre personnalisé de vCPU au lancement
<a name="cpu-options-customize-vCPUs-launch"></a>

Vous pouvez personnaliser le nombre de cœurs de CPU et de threads par cœur lorsque vous lancez une instance à partir de la console EC2 ou de la AWS CLI. Les exemples de cette section utilisent un type d’`r5.4xlarge`instance, qui possède les paramètres par défaut suivants :
+ Cœurs de CPU : 8
+ Threads par défaut : 2

Les instances sont lancées avec le nombre maximum de vCPU disponibles par défaut pour le type d’instance. Pour ce type d’instance, cela représente 16 vCPU au total (8 cœurs exécutant 2 threads chacun). Pour plus d’informations sur les types d’instance, consultez [instances de mémoire optimisée](cpu-options-supported-instances-values.md#cpu-options-mem-optimized).

L’exemple suivant lance une instance `r5.4xlarge` avec 4 vCPU.

------
#### [ Console ]

**Pour spécifier un nombre personnalisé de vCPU lors du lancement de l’instance**

1. Suivez la procédure [Lancez une instance EC2 à l’aide de l’assistant de lancement d’instance de la console](ec2-launch-instance-wizard.md) et configurez votre instance selon vos besoins.

1. Développez **Informations avancées** et cochez la case **Spécifier les options du processeur**.

1. Pour obtenir 4 vCPU, spécifiez 2 cœurs de CPU et 2 threads par cœur, comme suit :
   + Pour le **Nombre de cœurs**, choisissez **2**.
   + Sous **Threads per core (Threads par cœur)**, choisissez **2**.

1. Dans le panneau **Summary** (Résumé), vérifiez la configuration de votre instance, puis choisissez **Launch instance** (Lancer l’instance). Pour de plus amples informations, veuillez consulter [Lancez une instance EC2 à l’aide de l’assistant de lancement d’instance de la console](ec2-launch-instance-wizard.md).

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

**Pour spécifier un nombre personnalisé de vCPU lors du lancement de l’instance**  
Utilisez la AWS CLI commande [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) et spécifiez le nombre de cœurs de processeur et le nombre de threads dans le `--cpu-options` paramètre. Vous pouvez spécifier 2 cœurs de CPU et 2 threads par cœur afin d’obtenir 4 vCPU.

```
aws ec2 run-instances \
    --image-id {{ami-0abcdef1234567890}} \
    --instance-type {{r7i.4xlarge}} \
    --cpu-options "CoreCount={{2}},ThreadsPerCore={{2}}" \
    --key-name {{my-key-pair}}
```

Vous pouvez également spécifier 4 cœurs de CPU et 1 thread par cœur (désactiver SMT) afin d’obtenir 4 vCPU :

```
aws ec2 run-instances \
    --image-id {{ami-0abcdef1234567890}} \
    --instance-type {{r7i.4xlarge}} \
    --cpu-options "CoreCount={{4}},ThreadsPerCore={{1}}" \
    --key-name {{my-key-pair}}
```

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

**Pour spécifier un nombre personnalisé de vCPU lors du lancement de l’instance**  
Utilisez la [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html)commande et spécifiez le nombre de cœurs de processeur et le nombre de threads dans le `-CpuOptions` paramètre. Vous pouvez spécifier 2 cœurs de CPU et 2 threads par cœur afin d’obtenir 4 vCPU.

```
New-EC2Instance `
    -ImageId '{{ami-0abcdef1234567890}}' `
    -InstanceType '{{r7i.4xlarge}}' `
    -CpuOptions @{CoreCount={{2}}; ThreadsPerCore={{2}}} `
    -KeyName '{{my-key-pair}}'
```

Vous pouvez également spécifier 4 cœurs de CPU et 1 thread par cœur (désactiver SMT) afin d’obtenir 4 vCPU :

```
New-EC2Instance `
    -ImageId '{{ami-0abcdef1234567890}}' `
    -InstanceType '{{r7i.4xlarge}}' `
    -CpuOptions @{CoreCount={{4}}; ThreadsPerCore={{1}}} `
    -KeyName '{{my-key-pair}}'
```

------

## Spécifier un nombre personnalisé de vCPU dans un modèle de lancement
<a name="cpu-options-customize-vCPUs-launch-template"></a>

Vous pouvez personnaliser le nombre de cœurs de CPU et de threads par cœur pour l’instance dans un modèle de lancement. Les exemples de cette section utilisent un type d’`r5.4xlarge`instance, qui possède les paramètres par défaut suivants :
+ Cœurs de CPU : 8
+ Threads par défaut : 2

Les instances sont lancées avec le nombre maximum de vCPU disponibles par défaut pour le type d’instance. Pour ce type d’instance, cela représente 16 vCPU au total (8 cœurs exécutant 2 threads chacun). Pour plus d’informations sur les types d’instance, consultez [instances de mémoire optimisée](cpu-options-supported-instances-values.md#cpu-options-mem-optimized).

L’exemple suivant crée un modèle de lancement qui spécifie la configuration d’une instance `r5.4xlarge` avec 4 vCPU.

------
#### [ Console ]

**Pour spécifier un nombre personnalisé de vCPU dans un modèle de lancement**

1. Suivez la procédure [Créer un modèle de lancement en spécifiant des paramètres](create-launch-template.md#create-launch-template-define-parameters) et configurez votre modèle de lancement selon vos besoins.

1. Développez **Informations avancées** et cochez la case **Spécifier les options d’UC**.

1. Pour obtenir 4 vCPU, spécifiez 2 cœurs de CPU et 2 threads par cœur, comme suit :
   + Pour le **Nombre de cœurs**, choisissez **2**.
   + Sous **Threads per core (Threads par cœur)**, choisissez **2**.

1. Dans le panneau **Résumé**, vérifiez la configuration de votre instance, puis choisissez **Créer un modèle de lancement**. Pour de plus amples informations, veuillez consulter [Stocker les paramètres de lancement des instances dans les modèles de lancement Amazon EC2](ec2-launch-templates.md).

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

**Pour spécifier un nombre personnalisé de vCPU dans un modèle de lancement**  
Utilisez la AWS CLI commande [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html) et spécifiez le nombre de cœurs de processeur et le nombre de threads dans le paramètre. `CpuOptions` Vous pouvez spécifier 2 cœurs de CPU et 2 threads par cœur afin d’obtenir 4 vCPU.

```
aws ec2 create-launch-template \
    --launch-template-name {{TemplateForCPUOptions}} \
    --version-description {{CPUOptionsVersion1}} \
    --launch-template-data file://{{template-data}}.json
```

Vous trouverez ci-dessous un exemple de fichier JSON contenant les données du modèle de lancement, qui inclut les options CPU, pour la configuration de l’instance de cet exemple.

```
{
    "NetworkInterfaces": [{
        "AssociatePublicIpAddress": true,
        "DeviceIndex": 0,
        "Ipv6AddressCount": 1,
        "SubnetId": "{{subnet-0abcdef1234567890}}"
    }],
    "ImageId": "{{ami-0abcdef1234567890}}",
    "InstanceType": "{{r5.4xlarge}}",
    "TagSpecifications": [{
        "ResourceType": "instance",
        "Tags": [{
            "Key":"{{Name}}",
            "Value":"{{webserver}}"
        }]
    }],
    "CpuOptions": {
        "CoreCount":{{2}},
        "ThreadsPerCore":{{2}}
    }
}
```

Vous pouvez également spécifier 4 cœurs de CPU et 1 thread par cœur (désactiver SMT) pour obtenir 4 vCPU :

```
{
    "NetworkInterfaces": [{
        "AssociatePublicIpAddress": true,
        "DeviceIndex": 0,
        "Ipv6AddressCount": 1,
        "SubnetId": "{{subnet-0abcdef1234567890}}"
    }],
    "ImageId": "{{ami-0abcdef1234567890}}",
    "InstanceType": "{{r5.4xlarge}}",
    "TagSpecifications": [{
        "ResourceType": "instance",
        "Tags": [{
            "Key":"{{Name}}",
            "Value":"{{webserver}}"
        }]
    }],
    "CpuOptions": {
        "CoreCount":{{4}},
        "ThreadsPerCore":{{1}}
    }
}
```

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

**Pour spécifier un nombre personnalisé de vCPU dans un modèle de lancement**  
Utilisez [New-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplate.html).

```
New-EC2LaunchTemplate `
    -LaunchTemplateName '{{TemplateForCPUOptions}}' `
    -VersionDescription '{{CPUOptionsVersion1}}' `
    -LaunchTemplateData (Get-Content -Path '{{template-data.json}}' | ConvertFrom-Json)
```

------

## Modifier les options d’UC pour votre instance EC2
<a name="change-vCPUs-after-launch"></a>

À mesure que vos besoins évoluent au fil du temps, vous souhaiterez peut-être modifier la configuration des options de processeur pour une instance existante. Chaque thread exécuté sur votre instance est appelé UC virtuelle (vCPU). Vous pouvez modifier le nombre de vCPU exécutés pour une instance existante dans la console AWS CLI, l'API ou les SDK Amazon EC2. L’état de l’instance doit être `Stopped` le même pour que vous puissiez effectuer cette modification.

Pour afficher les étapes de la console ou de la ligne de commande, sélectionnez l’onglet correspondant à votre environnement. Pour obtenir des informations sur les demandes d'API et les réponses, consultez [ModifyInstanceCpuOptions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceCpuOptions.html)le manuel *Amazon EC2 API* Reference.

------
#### [ Console ]

Suivez cette procédure pour modifier le nombre de vCPU actifs pour votre instance par rapport au AWS Management Console.

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation de gauche, sélectionnez **Instances**. Cela ouvre la liste des instances définies pour le moment Région AWS.

1. Sélectionnez l'instance dans la liste **Instances**. Vous pouvez également sélectionner le lien de l’instance pour ouvrir la page de détails de l’instance.

1. Si l'instance est en cours d'exécution, vous devez l'arrêter avant de continuer. Choisissez **Arrêter l’instance** dans le menu **État de l’instance**.

1. Pour modifier la configuration de votre vCPU, choisissez **Modifier les options d’UC** dans **Paramètres de l’instance** dans le menu **Actions**. Cela ouvre la page **Modifier les options du processeur**.

1. Choisissez l’une des options d’UC suivantes pour modifier la configuration de votre instance.  
**Utiliser les options d’UC par défaut**  
Cette option réinitialise votre instance sur le nombre de vCPU par défaut pour votre type d’instance. Par défaut, tous les threads sont exécutés pour tous les cœurs de processeur.  
**Spécifier les options du processeur**  
Cette option permet de configurer le nombre de vCPU exécutés sur votre instance.

1. Si vous avez choisi **Spécifier les options d’UC**, les champs **vCPU actifs** sont affichés.
   + Utilisez le premier sélecteur pour configurer le nombre de threads pour chaque cœur d’UC. Pour désactiver le multithreading simultané, choisissez `1`.
   + Utilisez le second sélecteur pour configurer le nombre d’UC opérant sur votre instance.

   Les champs suivants se mettent à jour dynamiquement lorsque vous modifiez les sélecteurs d’options d’UC.
   + **vCPU actifs** : le nombre de cœurs d’UC multiplié par le nombre de threads par cœur, en fonction des sélections que vous avez effectuées. Par exemple, si vous sélectionnez 2 threads et 4 cœurs, cela équivaut à 8 vCPU.
   + **Nombre total de vCPU** : Le nombre maximal de vCPU pour le type d’instance. Par exemple, pour un type d’`m6i.4xlarge`instance, il s’agit de 16 vCPU (8 cœurs exécutant 2 threads chacun).

1. Pour appliquer vos mises à jour, choisissez **Modifier**.

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

Suivez cette procédure pour modifier le nombre de vCPU actifs pour votre instance par rapport au. AWS CLI

Utilisez la commande [modify-instance-cpu-options](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-cpu-options.html) et spécifiez le nombre de cœurs d’UC exécutés dans le paramètre `--core-count` et le nombre de threads exécutés par cœur dans le paramètre `--threads-per-core`.

Les exemples suivants montrent deux configurations possibles sur un type d’instance `m6i.4xlarge` pour exécuter huit vCPU sur l’instance spécifiée. La valeur par défaut pour ce type d’instance est de 16 vCPU (8 cœurs exécutant 2 threads chacun).

**Exemple 1 :** exécutez 4 cœurs de processeur avec 2 threads par cœur, pour un total de 8 vCPU.

```
aws ec2 modify-instance-cpu-options \
    --instance-id {{i-1234567890abcdef0}} \

    --core-count={{4}} \
    --threads-per-core={{2}}
```

**Exemple 2 :** désactivez le multithreading simultané en modifiant le nombre de threads exécutés par cœur en. `1` La configuration résultante exécute également un total de huit vCPU (huit cœurs d’UC avec un thread par cœur).

```
aws ec2 modify-instance-cpu-options \
    --instance-id {{1234567890abcdef0}} \
    --core-count={{8}} \
    --threads-per-core={{1}}
```

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

**Pour modifier le nombre de vCPU actifs pour une instance**  
Utilisez l'[Edit-EC2InstanceCpuOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceCpuOption.html)applet de commande et spécifiez le nombre de cœurs de processeur exécutés dans le `-CoreCount` paramètre et le nombre de threads exécutés par cœur dans le `ThreadsPerCore` paramètre.

**Exemple 1 :** exécutez 4 cœurs de processeur avec 2 threads par cœur, pour un total de 8 vCPU.

```
Edit-EC2InstanceCpuOption `
    -InstanceId '{{i-1234567890abcdef0}}' `
    -CoreCount 4 `
    -ThreadsPerCore 2
```

**Exemple 2 :** désactivez le multithreading simultané en modifiant le nombre de threads exécutés par cœur en. `1` La configuration résultante exécute également un total de huit vCPU (huit cœurs d’UC avec un thread par cœur).

```
Edit-EC2InstanceCpuOption `
    -InstanceId '{{i-1234567890abcdef0}}' `
    -CoreCount 8 `
    -ThreadsPerCore 1
```

------