Créer des VM
Vous pouvez créer une ou plusieurs machines virtuelles (VM) personnalisées dans le Cloud public ou dans un Net.
Vous pouvez définir les différentes caractéristiques des VM, et créer plusieurs VM dans une même requête de création. Ces VM sont groupées dans une même réservation. Pour modifier les caractéristiques que vous avez définies pour une VM, voir Modifier un attribut d’une VM.
Toutes les OMI officielles utilisent des keypairs comme système d’authentification. Pour lancer une VM depuis une OMI officielle, vous devez spécifier une keypair. Cependant, les OMI non officielles peuvent utiliser n’importe quel système d’authentification. Pour lancer une VM depuis une OMI non officielle, vous devez vérifier si une keypair est requise. Pour en savoir plus, voir À propos des keypairs.
Créer des VM avec Cockpit v2
Cockpit v2 vous permet de créer plusieurs VM dans une même requête de création. Ces VM sont groupées dans une même réservation.
Ouvrir la fenêtre Créer une VM
Dans le dashboard VM, cliquez sur Créer des VMs.
La fenêtre CRÉER DES VMs - MODE EXPERT apparaît.
Configurer votre VM
Choisir un nom, une option d’allocation et un comportement d’arrêt
-
(optionnel) Dans le champ Nom de la VM, tapez un nom pour votre VM.
Ce nom doit contenir entre 1 et 255 caractères ASCII imprimables.
Ce nom est utilisé comme tag associé à votre instance.
-
(optionnel) Cochez la case Dédiée pour créer des VM dédiées.
Pour en savoir plus, voir À propos des VM. -
(optionnel) Dans la liste Comportement à la coupure, sélectionnez une des valeurs suivantes :
-
Arrêter
: Lorsque vous coupez les VM, elles s’arrêtent. -
Terminer
: Lorsque vous coupez les VM, elles s’arrêtent puis sont terminées. -
Redémarrer
: Lorsque vous coupez les VM, elles s’arrêtent puis redémarrent automatiquement.
-
-
Cliquez sur Suivant.
L’écran de sélection d’une image apparaît.
Choisir une image
-
Sélectionnez une image pour vos VM.
-
Cliquez sur Suivant.
L’écran de sélection du type de VM apparaît.
Choisir un type de VM et le nombre de VM
-
Spécifiez les attributs suivants pour vos VM :
-
Génération du CPU : La génération du processeur.
-
Performance : L’indicateur de performance.
-
Très haute : Capacité de calcul maximum sur tous les vCPU de la VM. Cette valeur est idéale pour les applications de calcul intensif demandant des performances stables durant le cycle de vie de la VM.
-
Haute : Haute capacité de calcul sur tous les vCPU de la VM. Cette valeur s’applique à la plupart des cas et offre des performances variables dans le temps.
-
Moyenne : Performance à variation significative sur tous les vCPU de la VM. Cette valeur ne garantit pas des performances constantes, mais est idéale pour les machines à faible demande CPU.
-
-
Cœur(s) : Le nombre de vCores, jusqu’à 78.
-
Mémoire (Gio) : La quantité de mémoire, jusqu’à 1039 Gio.
Pour en savoir plus sur les types de VM, voir Types de VM.
Pour fonctionner correctement, les VM Windows nécessitent au moins un processeur de génération v3, 2 vCores et 4 Gio de mémoire.
-
-
Spécifiez combien de VM vous voulez créer.
-
Cliquez sur Suivant.
L’écran Net apparaît.
Choisir entre le Cloud public, un Net et une sous-région
-
Si vous voulez créer des VM dans le Cloud public :
-
Laissez Cloud public activé.
-
Sélectionnez la sous-région dans laquelle vous voulez créer vos VM.
Dans le Cloud public, vous ne pouvez pas définir l’IP privée de vos VM.
-
-
Si vous voulez créer des VM dans un Net :
-
Désactivez Cloud public.
-
Sélectionnez un de vos subnets dans la liste Subnet.
-
(optionnel) Dans le champ IP privée, si vous créez une seule VM, tapez l’IP privée de la VM.
Lorsque vous créez des VM dans un Net avec Cockpit v2 :
-
Seule la sous-région du Subnet choisi est affichée.
-
Des Network interface cards (NIC) sont automatiquement créées et attachées aux VM.
-
-
-
Cliquez sur Suivant.
L’écran de sélection d’un volume système apparaît.
Choisir un volume système
-
Si vous voulez que vos VM utilisent un volume système par défaut :
-
Sélectionnez Poursuivre avec un volume système par défaut.
-
(optionnel) Dans le champ Nom du volume, tapez un nom pour votre volume système.
-
-
Si vous voulez personnaliser le volume système de vos VM :
-
Sélectionnez Personnaliser le volume système.
-
(optionnel) Dans le champ Nom du volume, tapez un nom pour votre volume système.
-
Sélectionnez une des valeurs suivantes dans la liste Volume Type :
-
standard
pour un volume Magnetic -
gp2
pour un volume Performance -
io1
pour un volume EnterpriseSi vous sélectionnez
io1
, vous devez définir le nombre d’IOPS dont vous avez besoin.Pour en savoir plus, voir À propos des volumes > Types de volumes et IOPS.
-
-
Dans le champ Taille du volume, spécifiez la taille du volume (en Gio).
-
-
Cliquez sur Suivant.
L’écran Security group apparaît.
Choisir des security groups
-
Si vous voulez associer un nouveau security group à vos VM, sélectionnez Créer un nouveau security group :
-
Dans le champ Nom, tapez un nom pour le security group.
-
Dans le champ Description, tapez sa description.
-
Le nom doit être unique dans votre compte pour le Cloud public ou pour chaque Net.
-
Le nom du security group ne doit pas commencer par
sg-
. -
Chaque nom et description peut contenir entre 1 et 255 caractères. Les caractères autorisés sont a-z, A-Z, 0-9, l’espace et _.-:/()#,@[]+=&;\{}!$*.
-
-
-
Si vous voulez associer un ou plusieurs security groups existants à vos VM, sélectionnez Sélectionner un ou plusieurs security groups et sélectionnez-les dans la liste qui apparaît.
Cette liste dépend du choix effectué dans l’écran Public/Net. Si vous avez sélectionné un Net, seuls les security groups du Net choisi sont affichés.
-
Si vous voulez associer un security group par défaut à vos VM, sélectionnez Poursuivre avec un security group par défaut.
-
Cliquez sur Suivant.
L’écran de sélection d’une keypair apparaît.
Choisir une keypair
-
Si vous voulez attribuer une keypair existante à vos instances, sélectionnez-la dans la liste.
Seules les keypairs RSA peuvent déchiffrer le mot de passe d’une VM Windows.
-
Si vous voulez créer une nouvelle keypair à attribuer à vos instances, sélectionnez Créer une nouvelle keypair :
-
Dans le champ Nom de la keypair, tapez un nom pour la keypair.
-
Cliquez Créer et télécharger la keypair.
-
Le nom de la keypair doit être unique dans votre compte.
-
Il doit contenir entre 1 et 255 caractères ASCII imprimables.
Sauvegardez ce document avec précaution, car vous aurez besoin de son contenu à chaque connexion à vos ressources. Il ne peut pas être récupéré auprès de 3DS OUTSCALE en cas de perte.
-
-
-
Si vous ne voulez pas attribuer une keypair à vos VM, sélectionnez Poursuivre sans keypair.
Avec Cockpit v2, vous pouvez créer une VM sans y associer de keypair. Cependant, toutes les images officielles utilisent des keypairs comme système d’authentification. Si vous voulez accéder à une VM créée à partir d’une image officielle, vous devez donc y associer une keypair pendant cette étape ou plus tard. Pour associer une keypair plus tard, voir Modifier un attribut d’une VM.
-
Cliquez sur Suivant.
L’écran User data / Cloud-init apparaît.
Spécifier des user data
-
(optionnel) Tapez des user data pour les VM dans le champ Section Outscale.
Pour en savoir plus, voir Configurer une VM avec les user data et les tags OUTSCALE.Cockpit v2 encode ensuite ces user data en Base64. La taille des user data encodées en Base64 ne doit pas dépasser 500 kibioctets (Kio).
-
(optionnel) Tapez des user data pour les VM dans le champ Section libre / Cloud-init.
Pour en savoir plus, voir Utiliser cloud-init avec les user data.Cockpit v2 encode ensuite ces user data en Base64. La taille des user data encodées en Base64 ne doit pas dépasser 500 kibioctets (Kio).
-
Cliquez sur Suivant.
L’écran Récapitulatif apparaît.
Créer des VM avec OSC CLI
À ce jour, cette section est disponible en anglais uniquement. |
The CreateVms command creates virtual machines (VMs), and then launches them.
This action enables you to create a specified number of VMs using an OUTSCALE machine image (OMI) that you are allowed to use, and then to automatically launch them.
The VMs remain in the pending
state until they are created and ready to be used. Once automatically launched, they are in the running
state.
To check the state of your VMs, call the ReadVms method.
If not specified, the security group used by the service is the default one.
The metadata server enables you to get the public key provided when the VM is launched. Official OMIs contain a script to get this public key and put it inside the VM to provide secure access without password.
For more information, see About VMs.
$ osc-cli api CreateVms --profile "default" \
--ImageId "ami-12345678"
$ osc-cli api CreateVms --profile "default" \
--ImageId "ami-12345678" \
--VmType "tinav5.c1r1p2" \
--KeypairName "keypair-example" \
--SecurityGroupIds '["sg-12345678"]' \
--SubnetId "subnet-12345678" \
--UserData "$(base64 -i user_data.txt)"
$ osc-cli api CreateVms --profile "default" \
--ImageId "ami-12345678" \
--VmType "tinav5.c1r1p2" \
--KeypairName "keypair-example" \
--SecurityGroupIds '["sg-12345678"]' \
--SubnetId "subnet-12345678" \
--UserData "$(base64 -i user_data.txt)" \
--BlockDeviceMappings '[
{
"DeviceName": "/dev/sda1",
"Bsu": {"VolumeSize": 15, "VolumeType": "gp2"},
},
{
"DeviceName": "/dev/sdb",
"Bsu": {"SnapshotId": "snap-12345678", "VolumeSize": 22, "VolumeType": "io1", "Iops": 150},
},
]'
$ osc-cli api CreateVms --profile "default" \
--ImageId "ami-12345678" \
--VmType "tinav5.c1r1p2" \
--KeypairName "keypair-example" \
--UserData "$(base64 -i user_data.txt)" \
--Nics '[
{
"DeviceNumber": 0,
"NicId": "eni-12345678",
},
]'
This command contains the following attributes that you need to specify:
-
BlockDeviceMappings
: (optional) One or more block device mappings. -
BootOnCreation
: (optional) By default or if true, the VM is started on creation. If false, the VM is stopped on creation. -
BsuOptimized
: (optional) This parameter is not available. It is present in our API for the sake of historical compatibility with AWS. -
ClientToken
: (optional) A unique identifier which enables you to manage the idempotency. -
DeletionProtection
: (optional) If true, you cannot delete the VM unless you change this parameter back to false. -
DryRun
: (optional) If true, checks whether you have the required permissions to perform the action. -
ImageId
: The ID of the OMI used to create the VM. You can find the list of OMIs by calling the ReadImages method. -
KeypairName
: (optional) The name of the keypair. -
MaxVmsCount
: (optional) The maximum number of VMs you want to create. If all the VMs cannot be created, the largest possible number of VMs above MinVmsCount is created. -
MinVmsCount
: (optional) The minimum number of VMs you want to create. If this number of VMs cannot be created, no VMs are created. -
NestedVirtualization
: (optional) (dedicated tenancy only) If true, nested virtualization is enabled. If false, it is disabled. -
Nics
: (optional) One or more NICs. If you specify this parameter, you must not specify theSubnetId
andSubregionName
parameters. You also must define one NIC as the primary network interface of the VM with0
as its device number. -
Performance
: (optional) The performance of the VM (medium
|high
|highest
). By default,high
. This parameter is ignored if you specify a performance flag directly in theVmType
parameter. -
Placement
: (optional) Information about the placement of the VM. -
PrivateIps
: (optional) One or more private IPs of the VM. -
SecurityGroupIds
: (optional) One or more IDs of security group for the VMs. -
SecurityGroups
: (optional) One or more names of security groups for the VMs. -
SubnetId
: (optional) The ID of the Subnet in which you want to create the VM. If you specify this parameter, you must not specify theNics
parameter. -
UserData
: (optional) Data or script used to add a specific configuration to the VM. It must be Base64-encoded and is limited to 500 kibibytes (KiB). -
VmInitiatedShutdownBehavior
: (optional) The VM behavior when you stop it. By default or if set tostop
, the VM stops. If set torestart
, the VM stops then automatically restarts. If set toterminate
, the VM stops and is terminated. -
VmType
: (optional) The type of VM. You can specify a TINA type (in thetinavW.cXrYpZ
ortinavW.cXrY
format), or an AWS type (for example,t2.small
, which is the default value).
If you specify an AWS type, it is converted in the background to its corresponding TINA type, but the AWS type is still returned. If the specified or converted TINA type includes a performance flag, this performance flag is applied regardless of the value you may have provided in thePerformance
parameter. For more information, see VM Types.
The CreateVms command returns the following elements:
-
ResponseContext
: Information about the context of the response. -
Vms
: Information about one or more created VMs.
{
"Vms": [
{
"VmType": "t2.small",
"VmInitiatedShutdownBehavior": "stop",
"State": "pending",
"StateReason": "",
"RootDeviceType": "ebs",
"RootDeviceName": "/dev/sda1",
"IsSourceDestChecked": true,
"ImageId": "ami-12345678",
"DeletionProtection": false,
"Architecture": "x86_64",
"NestedVirtualization": false,
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Bsu": {
"VolumeId": "vol-12345678",
"State": "attaching",
"LinkDate": "2010-10-01T12:34:56.789Z",
"DeleteOnVmDeletion": true
}
}
],
"VmId": "i-12345678",
"ReservationId": "r-12345678",
"Hypervisor": "xen",
"Placement": {
"Tenancy": "default",
"SubregionName": "eu-west-2a"
},
"ProductCodes": [
"0001"
],
"CreationDate": "2010-10-01T12:34:56.789Z",
"UserData": "...",
"PrivateIp": "10.0.0.4",
"SecurityGroups": [
{
"SecurityGroupName": "default",
"SecurityGroupId": "sg-12345678"
}
],
"BsuOptimized": false,
"LaunchNumber": 0,
"Performance": "medium",
"Tags": [],
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal"
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
{
"Vms": [
{
"VmType": "tinav5.c1r1p2",
"VmInitiatedShutdownBehavior": "stop",
"State": "pending",
"StateReason": "",
"RootDeviceType": "ebs",
"RootDeviceName": "/dev/sda1",
"IsSourceDestChecked": true,
"KeypairName": "keypair-example",
"ImageId": "ami-12345678",
"DeletionProtection": false,
"Architecture": "x86_64",
"NestedVirtualization": false,
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Bsu": {
"VolumeId": "vol-12345678",
"State": "attaching",
"LinkDate": "2010-10-01T12:34:56.789Z",
"DeleteOnVmDeletion": true
}
}
],
"VmId": "i-12345678",
"ReservationId": "r-12345678",
"Hypervisor": "xen",
"Placement": {
"Tenancy": "default",
"SubregionName": "eu-west-2a"
},
"ProductCodes": [
"0001"
],
"CreationDate": "2010-10-01T12:34:56.789Z",
"UserData": "...",
"SubnetId": "subnet-12345678",
"PrivateIp": "10.0.0.4",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"BsuOptimized": false,
"LaunchNumber": 0,
"NetId": "vpc-12345678",
"Nics": [
{
"SubnetId": "subnet-12345678",
"State": "in-use",
"LinkNic": {
"State": "attached",
"DeviceNumber": 0,
"LinkNicId": "eni-attach-12345678",
"DeleteOnVmDeletion": true
},
"IsSourceDestChecked": true,
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"Description": "Primary network interface",
"AccountId": "123456789012",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"MacAddress": "A1:B2:C3:D4:E5:F6",
"NetId": "vpc-12345678",
"NicId": "eni-12345678",
"PrivateIps": [
{
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"PrivateIp": "10.0.0.4",
"IsPrimary": true
}
]
}
],
"Performance": "high",
"Tags": [],
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal"
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
{
"Vms": [
{
"VmType": "tinav5.c1r1p2",
"VmInitiatedShutdownBehavior": "stop",
"State": "pending",
"StateReason": "",
"RootDeviceType": "ebs",
"RootDeviceName": "/dev/sda1",
"IsSourceDestChecked": true,
"KeypairName": "keypair-example",
"ImageId": "ami-12345678",
"DeletionProtection": false,
"Architecture": "x86_64",
"NestedVirtualization": false,
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Bsu": {
"VolumeId": "vol-12345678",
"State": "attaching",
"LinkDate": "2010-10-01T12:34:56.789Z",
"DeleteOnVmDeletion": true
}
},
{
"DeviceName": "/dev/sda1",
"Bsu": {
"VolumeId": "vol-87654321",
"State": "attaching",
"LinkDate": "2010-10-01T12:34:56.789Z",
"DeleteOnVmDeletion": true
}
}
],
"VmId": "i-12345678",
"ReservationId": "r-12345678",
"Hypervisor": "xen",
"Placement": {
"Tenancy": "default",
"SubregionName": "eu-west-2a"
},
"ProductCodes": [
"0001"
],
"CreationDate": "2010-10-01T12:34:56.789Z",
"UserData": "...",
"SubnetId": "subnet-12345678",
"PrivateIp": "10.0.0.4",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"BsuOptimized": false,
"LaunchNumber": 0,
"NetId": "vpc-12345678",
"Nics": [
{
"SubnetId": "subnet-12345678",
"State": "in-use",
"LinkNic": {
"State": "attached",
"DeviceNumber": 0,
"LinkNicId": "eni-attach-12345678",
"DeleteOnVmDeletion": true
},
"IsSourceDestChecked": true,
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"Description": "Primary network interface",
"AccountId": "123456789012",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"MacAddress": "A1:B2:C3:D4:E5:F6",
"NetId": "vpc-12345678",
"NicId": "eni-12345678",
"PrivateIps": [
{
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"PrivateIp": "10.0.0.4",
"IsPrimary": true
}
]
}
],
"Performance": "high",
"Tags": [],
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal"
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
{
"Vms": [
{
"VmType": "tinav5.c1r1p2",
"VmInitiatedShutdownBehavior": "stop",
"State": "pending",
"StateReason": "",
"RootDeviceType": "ebs",
"RootDeviceName": "/dev/sda1",
"IsSourceDestChecked": true,
"KeypairName": "keypair-example",
"ImageId": "ami-12345678",
"DeletionProtection": false,
"Architecture": "x86_64",
"NestedVirtualization": false,
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Bsu": {
"VolumeId": "vol-12345678",
"State": "attaching",
"LinkDate": "2010-10-01T12:34:56.789Z",
"DeleteOnVmDeletion": true
}
}
],
"VmId": "i-12345678",
"ReservationId": "r-12345678",
"Hypervisor": "xen",
"Placement": {
"Tenancy": "default",
"SubregionName": "eu-west-2a"
},
"ProductCodes": [
"0001"
],
"CreationDate": "2010-10-01T12:34:56.789Z",
"UserData": "...",
"SubnetId": "subnet-12345678",
"PrivateIp": "10.0.0.4",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"BsuOptimized": false,
"LaunchNumber": 0,
"NetId": "vpc-12345678",
"Nics": [
{
"SubnetId": "subnet-12345678",
"State": "in-use",
"LinkNic": {
"State": "attached",
"DeviceNumber": 0,
"LinkNicId": "eni-attach-12345678",
"DeleteOnVmDeletion": true
},
"IsSourceDestChecked": true,
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"Description": "Example NIC",
"AccountId": "123456789012",
"SecurityGroups": [
{
"SecurityGroupName": "security-group-example",
"SecurityGroupId": "sg-12345678"
}
],
"MacAddress": "A1:B2:C3:D4:E5:F6",
"NetId": "vpc-12345678",
"NicId": "eni-12345678",
"PrivateIps": [
{
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal",
"PrivateIp": "10.0.0.4",
"IsPrimary": true
}
]
}
],
"Performance": "high",
"Tags": [],
"PrivateDnsName": "ip-10-0-0-4.eu-west-2.compute.internal"
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
Lancer des instances avec AWS CLI
Pour lancer une ou plusieurs instances, utilisez la commande run-instances en suivant une de ces syntaxes :
$ aws ec2 run-instances \
--profile YOUR_PROFILE \
--image-id ami-12345678 \
--endpoint https://fcu.eu-west-2.outscale.com
$ aws ec2 run-instances \
--profile YOUR_PROFILE \
--image-id ami-12345678 \
--key-name \
--security-groups \
--security-group-ids sg-187654321 \
--user-data YOUR_USER_DATA \
--instance-type t2.small \
--placement \
"{ \
\"AvailabilityZone\": \"eu-west-2a\", \
\"Tenancy\": \"default\", \
}" \
--block-device-mappings YOUR_BLOCK_DEVICE_MAPPINGS \
--subnet-id subnet-12345678 \
--disable-api-termination \
--instance-initiated-shutdown-behavior stop \
--private-ip-address 10.0.1.100 \
--client-token "" \
--network-interfaces \
"{ \
\"NetworkInterfaceId\": \"eni-12345678\", \
\"DeviceIndex\": 0, \
\"SubnetId\": \"subnet-12345678\", \
\"Description\": \"Network interface description\", \
\"PrivateIpAddress\": \"10.0.1.100\", \
\"Groups\": \"sg-187654321\", \
\"DeleteOnTermination\": false \
\"PrivateIpAddresses\": [ \
{ \
\"PrivateIpAddress\": \"10.0.1.100\", \
\"Primary\": true \
} \
}" \
[--ebs-optimized NOT_SPECIFIED] \
--count 1 \
--endpoint https://fcu.eu-west-2.outscale.com
Cette commande contient les attributs suivants que vous devez spécifier :
-
(optionnel)
profile
: Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI. -
image-id
: L’ID de l’OMI à utiliser pour lancer l’instance. Pour en savoir plus, voir Obtenir des informations sur vos OMI. -
(optionnel)
key-name
: Le nom de la keypair à utiliser pour l’instance. Pour en savoir plus, voir À propos des keypairs.Il est fortement recommandé de spécifier une keypair au lancement de l’instance. Sinon, vous ne pouvez pas vous connecter à l’instance avant de lui avoir ajouté une keypair. Pour en savoir plus, voir Modifier la keypair d’une VM.
-
(optionnel)
security-groups
: Un ou plusieurs noms de security groups (seulement dans le Cloud public). Si non spécifié, le security group Default est utilisé. -
(optionnel)
security-group-ids
: Un ou plusieurs ID de security groups. Si non spécifié, le security group Default est utilisé. -
(optionnel)
user-data
: Les user data pour l’instance. Pour en savoir plus, voir Configurer une VM avec les user data et les tags OUTSCALE.AWS CLI encode ensuite ces user data en Base64. La taille des user data encodées en Base64 ne doit pas dépasser 500 kibioctets (Kio).
-
(optionnel)
instance-type
: Le type d’instance. Si non spécifié, une instance t2.small est lancée. Pour en savoir plus, voir Types de VM.Pour fonctionner correctement, les VMs Windows nécessitent au moins un processeur de génération v3, 2 vCores et 4 Gio de mémoire.
-
(optionnel)
placement
: Le placement de l’instance. Cet attribut contient les éléments suivants que vous devez spécifier :-
AvailabilityZone
: L’Availability Zone (AZ) dans laquelle vous voulez lancer l’instance.Si vous ne spécifiez aucune Sous-région, la Sous-région A est utilisée par défaut.
-
Tenancy
: L’option d’allocation de l’instance (dedicated
|default
). Pour en savoir plus, voir À propos des instances > Allocation des instances et instances dédiées.
-
-
(optionnel)
block-device-mappings
: Un ou plusieurs block device mappings pour l’instance. Pour en savoir plus, voir Définir des block device mappings. -
(optionnel)
subnet-id
: Dans un VPC, l’ID du subnet dans lequel vous souhaitez lancer l’instance. -
(optionnel)
disable-api-termination|enable-api-termination
: Désactive ou active la possibilité de terminer l’instance (par défaut, activé). -
(optionnel)
instance-initiated-shutdown-behavior
: Par défaut ou si paramétré surstop
, l’instance est arrêtée lorsque vous l’arrêtez ou la terminez. Si paramétré surterminate
, elle est arrêtée puis terminée. Si paramétré sur restart, l’instance est arrêtée puis automatiquement redémarrée. Pour en savoir plus, voir À propos du cycle de vie des instances > Suppression. -
(optionnel)
private-ip-address
: Dans un VPC, l’IP principale.L’IP doit faire partie de la plage d’IP du subnet.
-
(optionnel)
client-token
: Un identifiant unique qui vous permet de gérer l’idempotence (s’il y en a un). -
(optionnel)
network-interfaces
: Une ou plusieurs interfaces réseau. Si vous spécifiez ce paramètre, vous devez définir l’interface réseau principale de l’instance avec 0 en index du périphérique.
Cet attribut contient les éléments suivants que vous devez spécifier :-
NetworkInterfaceId
: L’ID de l’interface réseau de l’instance. -
DeviceIndex
: L’index du périphérique pour l’interface réseau (entre 0 et 7, tous deux inclus). -
SubnetId
: L’ID du subnet associé à l’interface réseau, si vous en créez une en lançant l’instance. -
Description
: Une description de l’interface réseau. -
PrivateIpAddress
: L’IP privée de l’interface réseau. -
Groups
: L’ID d’un ou plusieurs security groups à associer à l’interface réseau. -
DeleteOnTermination
: Par défaut ou si paramétré surtrue
, l’interface réseau est supprimée lorsque l’instance est terminée. Vous pouvez spécifier ce paramètre uniquement pour une nouvelle interface réseau. Pour modifier cette valeur pour une interface réseau existante, voir Modifier un attribut d’une NIC. -
PrivateIpAddresses
: Une ou plusieurs IP privées à associer à l’interface réseau.-
Primary
: Si paramétré surtrue
, l’IP est la principale.Une seule IP peut être principale.
-
PrivateIpAddress
: L’IP privée.
-
-
-
(optionnel)
ebs-optimized
: Indique si l’instance est optimisée pour BSU. -
(optionnel)
count
: Le nombre d’instances à lancer.Vous pouvez spécifier :
-
Un nombre seul, considéré comme le nombre minimum d’instances à lancer (par défaut, 1).
-
Une plage de nombres au format min:max. Le premier nombre est le nombre minimum d’instances à lancer, le deuxième est le maximum.
-
-
endpoint
: Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.
La commande run-instances renvoie les éléments suivants :
-
OwnerId
: L’ID de compte du propriétaire de l’instance. -
Reservation
: L’ID de la réservation. Pour en savoir plus, voir À propos des instances > Informations générales sur les instances. -
Groups
: Informations à propos des security groups associés à l’instance. -
Instances
: Informations à propos d’une ou plusieurs instances. Cet élément contient les informations suivantes pour chaque instance :-
Monitoring
: Indique si le monitoring est activé pour l’instance (toujoursdisabled
). -
PublicDnsName
: Le nom DNS public de l’instance. -
Platform
: Pas d’information renvoyée. -
State
: Informations à propos de l’état de l’instance (le code et le nom de l’état). -
EbsOptimized
: Indique si l’instance est optimisée pour BSU. -
LaunchTime
: Le moment auquel l’instance a été lancée. -
PublicIpAddress
: Dans un Cloud public, l’IP publique associée à l’instance (remplacée par l’External IP, s’il y en a une). Dans un VPC, l’External IP associée à l’instance, s’il y en a une. -
PrivateIpAddress
: L’IP privée de l’instance. -
ProductCodes
: Pas d’information renvoyée si vous utilisez une OMI officielle. -
Tags
: Un ou plusieurs tags associés à l’instance, avec leurValue
et leurKey
(s’il y en a). -
VpcId
: L’ID du VPC dans lequel l’instance est. -
InstanceId
: L’ID de l’instance. -
ImageId
: L’ID de l’OMI utilisée pour lancer l’instance. -
PrivateDnsName
: Le nom DNS privé de l’instance. -
KeyName
: Le nom de la keypair utilisée pour l’instance. Pour en savoir plus, voir À propos des keypairs. -
SecurityGroups
: Les security groups associés à l’instance (nom et ID). -
ClientToken
: Un identifiant unique qui vous permet de gérer l’idempotence (s’il y en a un). -
InstanceType
: Le type d’instance. pour en savoir plus, voir Types de VM. -
NetworkInterfaces
: Dans un VPC, une ou plusieurs interfaces réseau pour l’instance. -
Placement
: Information à propos du placement de l’instance. Cet élément contient les informations suivantes :-
Tenancy
: L’allocation de l’instance (dedicated
|default
). Pour en savoir plus, voir À propos des instances > Allocation des instances et instances dédiées. -
GroupName
: Pas d’information renvoyée. -
AvailabilityZone
: L’Availability Zone de l’instance.
-
-
SourceDestCheck
: Sitrue
, la vérification source/destination du trafic réseau est activée. Sifalse
, elle ne l’est pas. -
Hypervisor
: Le type d’hyperviseur de l’instance (toujoursxen
). -
BlockDeviceMappings
: Un ou plusieurs block device mappings pour l’nstance. Pour en savoir plus, voir Définir des block device mappings. -
Architecture
: L’architecture de l’instance. -
KernelId
: Pas d’information renvoyée. -
RootDeviceName
: Le nom du périphérique associé au volume système de l’instance. -
VirtualizationType
: Le type de virtualisation (toujourshvm
). -
RootDeviceType
: Le type de volume système de l’instance (toujoursebs
). -
AmiLaunchIndex
: L’index de lancement de l’instance. pour en savoir plus, voir À propos des instances > Informations générales sur les instances.
-
{
"OwnerId": "1234567890000",
"ReservationId": "r-87654321",
"Groups": [
{
"GroupName": "default",
"GroupId": "sg-12345678"
}
],
"Instances": [
{
"Monitoring": {
"State": "disabled"
},
"PublicDnsName": "",
"Platform": "",
"State": {
"Code": 0,
"Name": "pending"
},
"EbsOptimized": false,
"LaunchTime": "2016-04-20T08:26:26.540Z",
"PrivateIpAddress": "10.10.10.0",
"ProductCodes": [],
"VpcId": "vpc-56781234",
"InstanceId": "i-12345678",
"ImageId": "ami-87654321",
"PrivateDnsName": "ip-10-10-10-0.eu-west-2.compute.internal",
"KeyName": "key name",
"SecurityGroups": [
{
"GroupName": "default",
"GroupId": "sg-12345678"
}
],
"ClientToken": "",
"SubnetId": "subnet-56781234",
"InstanceType": "t2.small",
"NetworkInterfaces": [
{
"Status": "in-use",
"MacAddress": "aa:c0:00:00:00:00",
"SourceDestCheck": true,
"VpcId": "vpc-56781234",
"Description": "Primary network interface",
"NetworkInterfaceId": "eni-12345678",
"PrivateIpAddresses": [
{
"PrivateDnsName": "ip-10-10-10-0.eu-west-2.compute.internal",
"Primary": true,
"PrivateIpAddress": "10.10.10.0"
}
],
"PrivateDnsName": "ip-10-10-10-0.eu-west-2.compute.internal",
"Attachment": {
"Status": "attached",
"DeviceIndex": 0,
"DeleteOnTermination": true,
"AttachmentId": "eni-attach-12345678",
"AttachTime": "2016-04-20T08:26:26.540Z"
},
"Groups": [
{}
],
"SubnetId": "subnet-56781234",
"OwnerId": "249064296596",
"PrivateIpAddress": "10.10.10.0"
}
],
"SourceDestCheck": true,
"Placement": {
"Tenancy": "default",
"GroupName": "",
"AvailabilityZone": "eu-west-2a"
},
"Hypervisor": "xen",
"BlockDeviceMappings": [
{
"DeviceName": "/dev/sda1",
"Ebs": {
"Status": "attaching",
"DeleteOnTermination": true,
"VolumeId": "vol-87654321",
"AttachTime": "2016-04-20T08:26:26.540Z"
}
}
],
"Architecture": "x86_64",
"KernelId": "",
"RootDeviceName": "/dev/sda1",
"VirtualizationType": "hvm",
"RootDeviceType": "ebs",
"AmiLaunchIndex": 0
}
]
}
Les instances sont lancées.
Pages connexes
Méthodes API correspondantes
AWS™ et Amazon Web Services™ sont des marques de commerce d’Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.