Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Specify CPU options for your instance
You can specify CPU options during instance launch.
The following examples describe how to specify the CPU options when using the launch
instance wizard in the EC2 console and the run-instances Amazon CLI command, and
the create launch template page in the EC2 console and the create-launch-template
Amazon CLI command. For EC2 Fleet or Spot Fleet, you must specify the CPU options in a launch
template.
The following examples are for an r4.4xlarge
instance type, which has the
following default values:
-
Default CPU cores: 8
-
Default threads per core: 2
-
Default vCPUs: 16 (8 * 2)
-
Valid number of CPU cores: 1, 2, 3, 4, 5, 6, 7, 8
-
Valid number of threads per core: 1, 2
Disable
multithreading
To disable multithreading, specify 1 thread per core.
- New console
-
To disable multithreading during instance launch
-
Follow the Quickly launch an instance procedure and
configure your instance as needed.
-
Expand Advanced details, and select the Specify CPU
options check box.
-
For Core count, choose the number of required CPU
cores. In this example, to specify the default CPU core count for an
r4.4xlarge
instance, choose 8
.
-
To disable multithreading, for Threads per core, choose
1.
-
In the Summary panel, review your instance configuration, and then
choose Launch instance. For more information,
see Launch an instance using the new launch
instance wizard.
- Old console
-
To disable multithreading during instance launch
-
Follow the Launch an instance using the old launch instance wizard procedure.
-
On the Configure Instance Details page, for CPU
options, choose Specify CPU
options.
-
For Core count, choose the number of required CPU
cores. In this example, to specify the default CPU core count for an
r4.4xlarge
instance, choose 8
.
-
To disable multithreading, for Threads per core, choose
1.
-
Continue as prompted by the wizard. When you've finished reviewing your
options on the Review Instance Launch page, choose
Launch. For more information, see Launch an instance using the old launch instance wizard.
- Amazon CLI
-
To disable multithreading during instance launch
Use the run-instances
Amazon CLI command and specify a value of 1
for
ThreadsPerCore
for the --cpu-options
parameter. For CoreCount
, specify the number of CPU cores. In
this example, to specify the default CPU core count for an
r4.4xlarge
instance, specify a value of
8
.
aws ec2 run-instances \
--image-id ami-1a2b3c4d
\
--instance-type r4.4xlarge
\
--cpu-options "CoreCount=8
,ThreadsPerCore=1
" \
--key-name MyKeyPair
Specify a custom number of
vCPUs at launch
You can customize the number of CPU cores and threads per core for the
instance.
The following example launches an r4.4xlarge
instance with six
vCPUs.
- New console
-
To specify a custom number of vCPUs during instance launch
-
Follow the Quickly launch an instance procedure and
configure your instance as needed.
-
Expand Advanced details, and select the Specify CPU
options check box.
-
To get 6 vCPUs, specify 3 CPU cores and 2 threads per core, as
follows:
-
For Core count, choose
3.
-
For Threads per core, choose
2.
-
In the Summary panel, review your instance configuration, and then
choose Launch instance. For more information,
see Launch an instance using the new launch
instance wizard.
- Old console
-
To specify a custom number of vCPUs during instance launch
-
Follow the Launch an instance using the old launch instance wizard procedure.
-
On the Configure Instance Details page, for
CPU options, choose Specify CPU
options.
-
To get 6 vCPUs, specify 3 CPU cores and 2 threads per core, as
follows:
-
For Core count, choose
3.
-
For Threads per core, choose
2.
-
Continue as prompted by the wizard. When you've finished reviewing your
options on the Review Instance Launch page, choose
Launch. For more information, see Launch an instance using the old launch instance wizard.
- Amazon CLI
-
To specify a custom number of vCPUs during instance launch
Use the run-instances Amazon CLI command and specify the number of
CPU cores and number of threads in the --cpu-options
parameter. You can specify 3 CPU cores and 2 threads per core to get
6 vCPUs.
aws ec2 run-instances \
--image-id ami-1a2b3c4d
\
--instance-type r4.4xlarge
\
--cpu-options "CoreCount=3
,ThreadsPerCore=2
" \
--key-name MyKeyPair
Alternatively, specify 6 CPU cores and 1 thread per core (disable
multithreading) to get 6 vCPUs:
aws ec2 run-instances \
--image-id ami-1a2b3c4d
\
--instance-type r4.4xlarge
\
--cpu-options "CoreCount=6
,ThreadsPerCore=1
" \
--key-name MyKeyPair
Specify a custom number of
vCPUs in a launch template
You can customize the number of CPU cores and threads per core for the instance in
a launch template.
The following example creates a launch template that specifies the configuration
for an r4.4xlarge
instance with 6 vCPUs.
- Console
-
To specify a custom number of vCPUs in a launch template
-
Follow the Create a new launch
template using parameters you define procedure and
configure your launch template as needed.
-
Expand Advanced details, and select the Specify CPU
options check box.
-
To get 6 vCPUs, specify 3 CPU cores and 2 threads per core, as
follows:
-
For Core count, choose
3.
-
For Threads per core, choose
2.
-
In the Summary panel, review your
instance configuration, and then choose Create launch
template. For more information, see Launch an instance from a launch template.
- Amazon CLI
-
To specify a custom number of vCPUs in a launch template
Use the create-launch-template Amazon CLI command and specify the
number of CPU cores and number of threads in the
CpuOptions
parameter. You can specify 3 CPU
cores and 2 threads per core to get 6 vCPUs.
aws ec2 create-launch-template \
--launch-template-name TemplateForCPUOptions
\
--version-description CPUOptionsVersion1
\
--launch-template-data file://template-data
.json
The following is an example JSON file that contains the launch
template data, which includes the CPU options, for the instance configuration for this example.
{
"NetworkInterfaces": [{
"AssociatePublicIpAddress": true,
"DeviceIndex": 0,
"Ipv6AddressCount": 1,
"SubnetId": "subnet-7b16de0c
"
}],
"ImageId": "ami-8c1be5f6
",
"InstanceType": "r4.4xlarge
",
"TagSpecifications": [{
"ResourceType": "instance",
"Tags": [{
"Key":"Name
",
"Value":"webserver
"
}]
}],
"CpuOptions": {
"CoreCount":3
,
"ThreadsPerCore":2
}
}
Alternatively, specify 6 CPU cores and 1 thread per core (disable
multithreading) to get 6 vCPUs:
{
"NetworkInterfaces": [{
"AssociatePublicIpAddress": true,
"DeviceIndex": 0,
"Ipv6AddressCount": 1,
"SubnetId": "subnet-7b16de0c
"
}],
"ImageId": "ami-8c1be5f6
",
"InstanceType": "r4.4xlarge
",
"TagSpecifications": [{
"ResourceType": "instance",
"Tags": [{
"Key":"Name
",
"Value":"webserver
"
}]
}],
"CpuOptions": {
"CoreCount":6
,
"ThreadsPerCore":1
}
}