Utilisation de CreateVolume avec une CLI

PDF

Les exemples de code suivants illustrent comment utiliser CreateVolume.

CLI

AWS CLI

Pour créer un volume SSD à usage général (gp2) vide

L'create-volumeexemple suivant crée un volume SSD à usage général (gp2) de 80 GiB dans la zone de disponibilité spécifiée. Notez que la région actuelle doit l'êtreus-east-1, ou vous pouvez ajouter le --region paramètre 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 aucun type de volume, le type de volume par défaut estgp2.

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

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

L'create-volumeexemple 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 du snapshot 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'create-volumeexemple suivant crée un volume chiffré à l'aide de la clé CMK par défaut pour le chiffrement EBS. Si le chiffrement est désactivé par défaut, vous devez spécifier le --encrypted paramètre 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 est activé par défaut, l'exemple de commande suivant crée un volume chiffré, même sans le --encrypted paramètre.

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

Si vous utilisez le --kms-key-id paramètre pour spécifier une clé CMK gérée par le client, vous devez le --encrypted spécifier 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'create-volumeexemple 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

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.