翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

の一般的なパラメータタイプ AWS CLI

このセクションでは、いくつかの一般的なパラメータタイプと一般的に必要な形式について説明します。

特定のコマンドでパラメータの書式化に問題がある場合には、コマンド名の後に help と入力することによって、ヘルプを確認してみてください。各サブコマンドのヘルプには、オプションの名前と説明が示されています。オプションのパラメータタイプは、括弧内に一覧表示されています。ヘルプ表示の詳細については、「のヘルプとリソースへのアクセス AWS CLI」を参照してください。

文字列

文字列パラメータには、文字ASCIIセットの英数字、記号、空白を含めることができます。空白文字を含む文字列は引用符で囲まれている必要があります。予期しない結果を避けるため、標準の空白文字以外の記号や空白文字は使用せず、お使いの端末の引用符のルールに従うことをお勧めします。

一部の文字列パラメータはファイルからバイナリデータを受け取ることができます。例については、「バイナリファイル」を参照してください。

タイムスタンプ

タイムスタンプは ISO8601 標準に従ってフォーマットされます。これらは「DateTime」または「Date」パラメータと呼ばれることもあります。

$ aws ec2 describe-spot-price-history --start-time 2014-10-13T19:00:00Z

有効な形式は次のとおりです。

デフォルトでは、 AWS CLI バージョン 2 はすべてのレスポンス DateTime 値を 8601 ISO 形式に変換します。

cli_timestamp_format ファイル設定を使用して、タイプスタンプ形式を設定できます。

リスト

スペースで区切られた 1 つ以上の文字列。文字列項目にスペースがある場合は、その項目を引用符で囲む必要があります。予期しない結果を避けるため。お使いの端末の引用のルールを遵守してください。

$ aws ec2 describe-spot-price-history --instance-types m1.xlarge m1.medium

ブール値

オプションをオンまたはオフにするバイナリフラグです。例えば、ec2 describe-spot-price-history にはブール型の --dry-run パラメータがあり、このパラメータが指定されると、クエリを実際に実行することなくサービスのクエリを検証します。

$ aws ec2 describe-spot-price-history --dry-run

出力にはコマンドが正しい形式だったかどうかが示されます。このコマンドには、--no-dry-run バージョンのパラメータも含まれ、これを使用して、コマンドを通常どおりに実行することを明示的に示すことができます。これは、デフォルトの動作であるため、含める必要はありません。

整数

符号なしの整数。

$ aws ec2 describe-spot-price-history --max-items 5

バイナリ/blob (バイナリラージオブジェクト) とストリーミング blob

では AWS CLI、バイナリ値をコマンドラインで文字列として直接渡すことができます。blob には 2 つのタイプがあります。

blob

タイプ blob で、パラメータに値を渡すには、fileb:// プレフィックスを使用してバイナリデータを含むローカルファイルへのパスを指定する必要があります。fileb:// プレフィックスを使用して参照されるファイルは、常に、エンコードされていない raw バイナリとして扱われます。指定されたパスは、現在の作業ディレクトリに対する相対パスとして解釈されます。例えば、--plaintext の aws kms encrypt パラメータは blob です。

$ aws kms encrypt \
    --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
    --plaintext fileb://ExamplePlaintextFile \
    --output text \
    --query CiphertextBlob | base64 \
    --decode > ExampleEncryptedFile

ストリーミング blob

aws cloudsearchdomain upload-documents などのストリーミング blob はプレフィックスを使用しません。代わりに、ストリーミング blob パラメータは直接ファイルパスを使用してフォーマットされます。次の例では、aws cloudsearchdomain upload-documents コマンドに直接ファイルパス document-batch.json を使用しています。

$ aws cloudsearchdomain upload-documents \
    --endpoint-url https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com \
    --content-type application/json \
    --documents document-batch.json

マッピング

JSON または のCLI省略構文 を使用して指定されたキーと値のペアのセット。次のJSON例では、my-table という名前の Amazon DynamoDB テーブルから、マップパラメータ を使用して項目を読み取ります--key。パラメータは、ID という名前のプライマリキーを指定し、ネストされたJSON構造体の数値は 1 です。

コマンドラインでより高度なJSON使用法を得るには、 などのコマンドラインJSONプロセッサを使用してJSON文字列を作成するjqことを検討してください。の詳細についてはjq、「」の「jq リポジトリ」を参照してくださいGitHub。

$ aws dynamodb get-item --table-name my-table --key '{"id": {"N":"1"}}'

{
    "Item": {
        "name": {
            "S": "John"
        },
        "id": {
            "N": "1"
        }
    }
}

ドキュメント

ドキュメントタイプは、文字列JSON内に埋め込むことなくデータを送信するために使用されます。ドキュメントタイプによってサービスが任意のスキーマを提供することで、より柔軟なデータ型を使用できます。

これにより、値をエスケープすることなくJSONデータを送信できます。例えば、次のエスケープされたJSON入力を使用する代わりに、次のようにします。

{"document": "{\"key\":true}"}

次のドキュメントタイプが使用できます。

{"document": {"key": true}}

ドキュメントタイプに対し有効な値

ドキュメントタイプは柔軟な性質を持っているため、有効な値のタイプは複数あります。有効な値には次のようなものがあります。