Utilisation de CreateVolume avec une CLI - Amazon Elastic Compute Cloud

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 CreateVolume avec une CLI

Les exemples de code suivants illustrent comment utiliser CreateVolume.

CLI
AWS CLI

Pour créer un volume SSD polyvalent (gp2) vide

L’exemple create-volume suivant crée un volume SSD polyvalent (gp2) de 80 GiO dans la zone de disponibilité spécifiée. Notez que la région actuelle doit être us-east-1, ou vous pouvez ajouter le paramètre --region pour spécifier la région pour la commande.

aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --availability-zone us-east-1a

Sortie :

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 }

Si vous ne spécifiez pas de type de volume, le type de volume par défaut est gp2.

aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a

Exemple 2 : pour créer un volume SSD d’IOPS provisionnées (io1) à partir d’un instantané

L’exemple create-volume suivant crée un volume SSD d’IOPS provisionnées (io1) avec 1 000 IOPS provisionnées dans la zone de disponibilité spécifiée à l’aide de l’instantané spécifié.

aws ec2 create-volume \ --volume-type io1 \ --iops 1000 \ --snapshot-id snap-066877671789bd71b \ --availability-zone us-east-1a

Sortie :

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "io1", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 1000, "SnapshotId": "snap-066877671789bd71b", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 500 }

Exemple 3 : pour créer un volume chiffré

L’exemple create-volume suivant crée un volume chiffré à l’aide de la clé CMK par défaut pour le chiffrement EBS. Si le chiffrement par défaut est désactivé, vous devez spécifier le paramètre --encrypted comme suit.

aws ec2 create-volume \ --size 80 \ --encrypted \ --availability-zone us-east-1a

Sortie :

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": true, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 }

Si le chiffrement par défaut est activé, l’exemple de commande suivant crée un volume chiffré, même sans le paramètre --encrypted.

aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a

Si vous utilisez le paramètre --kms-key-id pour spécifier une clé CMK gérée par le client, vous devez également spécifier le paramètre --encrypted, même si le chiffrement est activé par défaut.

aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --encrypted \ --kms-key-id 0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE \ --availability-zone us-east-1a

Exemple 4 : pour créer un volume avec des balises

L’exemple create-volume suivant crée un volume et ajoute deux balises.

aws ec2 create-volume \ --availability-zone us-east-1a \ --volume-type gp2 \ --size 80 \ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'
  • Pour plus de détails sur l'API, reportez-vous CreateVolumeà la section Référence des AWS CLI commandes.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple crée le volume spécifié.

New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2

Sortie :

Attachments : {} AvailabilityZone : us-west-2a CreateTime : 12/22/2015 1:42:07 AM Encrypted : False Iops : 150 KmsKeyId : Size : 50 SnapshotId : State : creating Tags : {} VolumeId : vol-12345678 VolumeType : gp2

Exemple 2 : cet exemple de demande crée un volume et applique une balise avec une clé de pile et une valeur de production.

$tag = @{ Key="stack"; Value="production" } $tagspec = new-object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "volume" $tagspec.Tags.Add($tag) New-EC2Volume -Size 80 -AvailabilityZone "us-west-2a" -TagSpecification $tagspec
  • Pour plus de détails sur l'API, reportez-vous CreateVolumeà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple crée le volume spécifié.

New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2

Sortie :

Attachments : {} AvailabilityZone : us-west-2a CreateTime : 12/22/2015 1:42:07 AM Encrypted : False Iops : 150 KmsKeyId : Size : 50 SnapshotId : State : creating Tags : {} VolumeId : vol-12345678 VolumeType : gp2

Exemple 2 : cet exemple de demande crée un volume et applique une balise avec une clé de pile et une valeur de production.

$tag = @{ Key="stack"; Value="production" } $tagspec = new-object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "volume" $tagspec.Tags.Add($tag) New-EC2Volume -Size 80 -AvailabilityZone "us-west-2a" -TagSpecification $tagspec
  • Pour plus de détails sur l'API, reportez-vous CreateVolumeà 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, consultezCréation de EC2 ressources Amazon à l'aide d'un AWS SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.