Utiliser des guillemets et des littéraux avec des chaînes dans AWS CLI - AWS Command Line Interface
Utilisation de guillemets autour des chaînes contenant des espaces blancsUtilisation de guillemets à l’intérieur des chaînes

Cette documentation concerne AWS CLI uniquement la version 1 du.

Nous avons annoncé la sortie end-of-support de la AWS CLI version 1. Nous vous recommandons de migrer vers la AWS CLI version 2. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, consultez l'annonce. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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.

Utiliser des guillemets et des littéraux avec des chaînes dans AWS CLI

Il existe principalement deux manières d’utiliser des guillemets simples et doubles dans l’ AWS CLI.

Utilisation de guillemets autour des chaînes contenant des espaces blancs

Les noms des paramètres et leurs valeurs sont séparés par des espaces sur la ligne de commande. Si une valeur de chaîne contient un espace intégré, vous devez entourer la chaîne entière de guillemets pour éviter que l' AWS CLI espace ne soit mal interprété comme un séparateur entre la valeur et le nom du paramètre suivant. Le type de guillemet que vous utilisez dépend du système d'exploitation AWS CLI sur lequel vous l'exécutez.

Linux and macOS

Utilisation des guillemets simples ' ' 

$ aws ec2 create-key-pair --key-name 'my key pair'

Pour plus d’informations sur l’utilisation des guillemets, consultez la documentation utilisateur de votre shell préféré.

PowerShell

Guillemets simples (recommandé)

Les guillemets simples ' ' sont appelées chaînes verbatim. La chaîne est transmise à la commande exactement telle que vous la tapez, ce qui signifie que PowerShell les variables ne seront pas transmises.

PS C:\> aws ec2 create-key-pair --key-name 'my key pair'

Guillemets doubles

Les guillemets doubles " " sont appelés chaînes expandable. Les variables peuvent être transmises sous forme de chaînes extensibles.

PS C:\> aws ec2 create-key-pair --key-name "my key pair"

Pour plus d'informations sur l'utilisation des guillemets, voir À propos des règles de citation dans Microsoft PowerShell Docs.

Windows command prompt

Utilisation des guillemets doubles " ".

C:\> aws ec2 create-key-pair --key-name "my key pair"

Si vous le souhaitez, vous pouvez séparer le nom de paramètre de la valeur par un signe égal = au lieu d’un espace. Cela n’est généralement nécessaire que si la valeur du paramètre commence par un trait d’union.

$ aws ec2 delete-key-pair --key-name=-mykey

Utilisation de guillemets à l’intérieur des chaînes

Les chaînes peuvent contenir des guillemets, et votre shell peut avoir besoin de guillemets pour fonctionner correctement. L’un des types de valeurs de paramètre courants est une chaîne JSON. Ceci est complexe, car il inclut des espaces et des guillemets doubles " " autour du nom et de la valeur de chaque élément dans la structure JSON. La manière dont vous entrez des paramètres au format JSON sur la ligne de commande varie selon le système d’exploitation.

Pour une utilisation plus avancée du JSON dans la ligne de commande, pensez à utiliser un processeur JSON de ligne de commande, par exemple jq, pour créer des chaînes JSON. Pour plus d'informations surjq, consultez le référentiel jq sur GitHub.

Linux and macOS

Pour que Linux et macOS interprètent littéralement les chaînes, utilisez des guillemets simples ' ' pour entourer la structure de données JSON, comme dans l’exemple suivant. Il n’est pas nécessaire d’échapper les guillemets doubles intégrés dans la chaîne JSON, car ils sont traités littéralement. Comme le JSON est placé entre guillemets simples, tous les guillemets simples de la chaîne devront être échappés. Cela se fait généralement en utilisant une barre oblique inverse avant le guillemet simple \'.

$ aws ec2 run-instances \
    --image-id ami-12345678 \
    --block-device-mappings '[{"DeviceName":"/dev/sdb","Ebs":{"VolumeSize":20,"DeleteOnTermination":false,"VolumeType":"standard"}}]'

Pour plus d’informations sur l’utilisation des guillemets, consultez la documentation utilisateur de votre shell préféré.

PowerShell

Utilisez des guillemets simples ' ' ou des guillemets doubles " ".

Guillemets simples (recommandé)

Les guillemets simples ' ' sont appelées chaînes verbatim. La chaîne est transmise à la commande exactement telle que vous la tapez, ce qui signifie que PowerShell les variables ne seront pas transmises.

Étant donné que les structures de données JSON contiennent des guillemets doubles, nous vous recommandons d’utiliser des guillemets simples ' ' pour les entourer. Si vous utilisez des guillemets simples, il n’est pas nécessaire d’échapper les guillemets doubles intégrés dans la chaîne JSON. Cependant, vous devez éviter d’échapper chaque guillemet simple par un accent grave ` au sein de la structure JSON.

PS C:\> aws ec2 run-instances `
    --image-id ami-12345678 `
    --block-device-mappings '[{"DeviceName":"/dev/sdb","Ebs":{"VolumeSize":20,"DeleteOnTermination":false,"VolumeType":"standard"}}]'

Guillemets doubles

Les guillemets doubles " " sont appelés chaînes expandable. Les variables peuvent être transmises sous forme de chaînes extensibles.

Si vous utilisez des guillemets doubles, il n’est pas nécessaire d’échapper les guillemets simples intégrés dans la chaîne JSON. Cependant, vous devez éviter d’échapper chaque guillemet simple par un accent grave ` au sein de la structure JSON, comme dans l’exemple suivant.

PS C:\> aws ec2 run-instances `
    --image-id ami-12345678 `
    --block-device-mappings "[{`"DeviceName`":`"/dev/sdb`",`"Ebs`":{`"VolumeSize`":20,`"DeleteOnTermination`":false,`"VolumeType`":`"standard`"}}]"

Pour plus d'informations sur l'utilisation des guillemets, voir À propos des règles de citation dans Microsoft PowerShell Docs.

Avertissement

Avant d' PowerShell envoyer une commande au AWS CLI, il détermine si votre commande est interprétée à l'aide de règles classiques PowerShell ou entre CommandLineToArgvW guillemets. Lorsque PowerShell des processus l'utilisentCommandLineToArgvW, vous devez éviter les caractères marqués d'une barre oblique inversée\.

Pour plus d'informations sur CommandLineToArgvW in PowerShell, consultez What's up with the strange treatment of guillemets and backslashes par CommandLineToArgv W dans Microsoft DevBlogs, Everyone cite les arguments de ligne de commande de la mauvaise façon dans le blog Microsoft Docs, et sur la fonction CommandLineToArgv W dans Microsoft Docs.

Guillemets simples

Les guillemets simples ' ' sont appelées chaînes verbatim. La chaîne est transmise à la commande exactement telle que vous la tapez, ce qui signifie que PowerShell les variables ne seront pas transmises. Échappez les caractères avec une barre oblique inverse \.

PS C:\> aws ec2 run-instances `
    --image-id ami-12345678 `
    --block-device-mappings '[{\"DeviceName\":\"/dev/sdb\",\"Ebs\":{\"VolumeSize\":20,\"DeleteOnTermination\":false,\"VolumeType\":\"standard\"}}]'

Guillemets doubles

Les guillemets doubles " " sont appelés chaînes expandable. Les variables peuvent être transmises sous forme de chaînes expandable. Pour les chaînes entre guillemets, vous devez éviter d'utiliser deux fois `\ pour chaque guillemet au lieu de simplement utiliser un backtick. L’accent grave échappe la barre oblique inverse, puis la barre oblique inverse est utilisée comme caractère d’échappement pour le traitement de la commande CommandLineToArgvW.

PS C:\> aws ec2 run-instances `
    --image-id ami-12345678 `
    --block-device-mappings "[{`\"DeviceName`\":`\"/dev/sdb`\",`\"Ebs`\":{`\"VolumeSize`\":20,`\"DeleteOnTermination`\":false,`\"VolumeType`\":`\"standard`\"}}]"

Blobs (recommandé)

Pour contourner les règles PowerShell de citation pour la saisie de données JSON, utilisez Blobs pour transmettre vos données JSON directement au. AWS CLI Pour plus d’informations sur les blobs, consultez Blob.

Windows command prompt

L’invite de commande Windows exige que la structure de données JSON soit placée entre guillemets doubles " ". De plus, pour empêcher le processeur de commandes de mal interpréter les guillemets doubles incorporés dans la structure JSON, vous devez également échapper (ajouter une barre oblique inverse \ avant) chaque guillemet double " dans la structure de données JSON elle-même, comme dans l’exemple suivant. 

C:\> aws ec2 run-instances ^
    --image-id ami-12345678 ^
    --block-device-mappings "[{\"DeviceName\":\"/dev/sdb\",\"Ebs\":{\"VolumeSize\":20,\"DeleteOnTermination\":false,\"VolumeType\":\"standard\"}}]"

Seuls les guillemets doubles les plus à l’extérieur ne sont pas placés dans une séquence d’échappement.