翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
のヘルプとリソースへのアクセス AWS CLI
このトピックでは、 AWS Command Line Interface () のヘルプコンテンツにアクセスする方法について説明しますAWS CLI。
組み込みの AWS CLI help コマンド
AWS Command Line Interface () を使用する場合、どのコマンドでもヘルプを受けることができますAWS CLI。そのためには、コマンド名の末尾に help と入力するだけです。
例えば、次のコマンドは、一般的な AWS CLI オプションと使用可能な最上位コマンドのヘルプを表示します。
$aws help
次のコマンドは、使用可能な Amazon Elastic Compute Cloud (Amazon EC2) 固有のコマンドを表示します。
$aws ec2 help
次の例では、Amazon EC2DescribeInstancesオペレーションの詳細なヘルプを表示します。ヘルプには、入力パラメータ、使用可能なフィルター、および出力に含まれるものについての説明があります。コマンドの一般的なバリエーションを入力する方法を示す例も含まれています。
$aws ec2 describe-instances help
各コマンドのヘルプは 6 つのセクションに分かれています。
- 名前
-
コマンドの名前。
NAME describe-instances - - 説明
-
コマンドが呼び出すAPIオペレーションの説明。
DESCRIPTION Describes one or more of your instances. If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results. ... - 概要
-
コマンドとそのオプションを使用するための基本的な構文。オプションが角括弧で示されている場合は、そのオプションが任意である、デフォルト値がある、または使用できる代替オプションがあることを意味しています。
SYNOPSIS describe-instances [--dry-run | --no-dry-run] [--instance-ids <value>] [--filters <value>] [--cli-input-json <value>] [--starting-token <value>] [--page-size <value>] [--max-items <value>] [--generate-cli-skeleton]例えば、
describe-instancesには、現在のアカウントと AWS リージョン内のすべてのインスタンスを記述するデフォルトの動作があります。必要に応じてinstance-idsのリストを指定して、1 つ以上のインスタンスを定義することもできます。dry-runは値を取らないオプションのブールフラグです。ブールフラグを使用するには、表示される値のいずれかを指定します。この場合は--dry-runまたは--no-dry-runです。同様に、--generate-cli-skeletonも値を取りません。オプションの使用に条件がある場合は、OPTIONSセクションで説明されるか、例に示されます。 - オプション
-
Synopsis に示される各オプションの説明。
OPTIONS --dry-run | --no-dry-run (boolean) Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRun- Operation . Otherwise, it is UnauthorizedOperation . --instance-ids (list) One or more instance IDs. Default: Describes all your instances. ... - 例
-
コマンドとそのオプションの使用方法を示す例。必要なコマンドまたはユースケースの例がない場合は、このページのフィードバックリンク、または AWS CLI コマンドのヘルプページのコマンドリファレンスを使用してリクエストします。
EXAMPLES To describe an Amazon EC2 instance Command: aws ec2 describe-instances --instance-ids i-5203422c To describe all instances with the instance type m1.small Command: aws ec2 describe-instances --filters "Name=instance-type,Values=m1.small" To describe all instances with an Owner tag Command: aws ec2 describe-instances --filters "Name=tag-key,Values=Owner" ... - 出力
-
からの応答に含まれる各フィールドとデータタイプの説明 AWS
describe-instancesの場合は、出力は予約オブジェクトのリストであり、それぞれのオブジェクトに、関連付けられたインスタンスに関する情報を含む複数のフィールドとオブジェクトがあります。この情報は、Amazon で使用されるAPI予約データタイプのドキュメントから取得されますEC2。OUTPUT Reservations -> (list) One or more reservations. (structure) Describes a reservation. ReservationId -> (string) The ID of the reservation. OwnerId -> (string) The ID of the AWS account that owns the reservation. RequesterId -> (string) The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling). Groups -> (list) One or more security groups. (structure) Describes a security group. GroupName -> (string) The name of the security group. GroupId -> (string) The ID of the security group. Instances -> (list) One or more instances. (structure) Describes an instance. InstanceId -> (string) The ID of the instance. ImageId -> (string) The ID of the AMI used to launch the instance. State -> (structure) The current state of the instance. Code -> (integer) The low byte represents the state. The high byte is an opaque internal value and should be ignored. ...が出力を に AWS CLI レンダリングするとJSON、次の例のように予約オブジェクトの配列になります。
{ "Reservations": [ { "OwnerId": "012345678901", "ReservationId": "r-4c58f8a0", "Groups": [], "RequesterId": "012345678901", "Instances": [ { "Monitoring": { "State": "disabled" }, "PublicDnsName": "ec2-52-74-16-12.us-west-2.compute.amazonaws.com", "State": { "Code": 16, "Name": "running" }, ...各予約オブジェクトには、予約およびインスタンスオブジェクトの配列を説明するフィールドがあり、それぞれにそれを説明する独自のフィールド (例:
PublicDnsName) とオブジェクト (例:State) があります。Windows ユーザー
ヘルプコマンドの出力を
moreコマンドにパイプ (|) して、ヘルプファイルを 1 ページずつ表示することができます。スペースバー または PgDnを押してドキュメントをさらに表示し、q終了します。C:\>aws ec2 describe-instances help | more
AWS CLI リファレンスガイド
ヘルプファイルには、コマンドラインからは表示や移動ができないリンクが含まれています。これらのリンクを表示して操作するには、オンラインAWS CLI バージョン 2 リファレンスガイド
API ドキュメント
のすべてのコマンドは、 AWS サービスのパブリック に対するリクエスト AWS CLI に対応しますAPI。パブリックを持つ各サービスAPIには、AWS ドキュメントウェブサイト
API ドキュメントセクション
-
アクション - 各オペレーションとそのパラメータに関する詳細情報 (長さまたは内容に関する制約、デフォルト値を含む)。このオペレーションで発生する可能性のあるエラーが一覧表示されます。各オペレーションは、 のサブコマンドに対応します AWS CLI。
-
データタイプ - コマンドが必要なパラメータそして、リクエストに応答して返す構造体に関する詳細情報。
-
Common Parameters - サービスのすべてのアクションに共通のパラメータに関する詳細情報。
-
Common Errors - サービスの操作によって返される可能性のあるエラーに関する詳細情報。
各セクションの名前と有無は、サービスによって異なる場合があります。
サービス固有 CLIs
一部のサービスには、すべての サービスを操作するために 1 つの AWS CLI が作成される前とは別の CLI があります。これらのサービス固有のドキュメントにはCLIs、サービスのドキュメントページにリンクされた個別のドキュメントがあります。サービス固有のドキュメントCLIsは、 には適用されません AWS CLI。
エラーのトラブルシューティング
AWS CLI エラーの診断と修正については、「」を参照してくださいのエラーのトラブルシューティング AWS CLI。
その他のヘルプ
AWS CLI 問題に関するその他のヘルプについては、 のAWS CLI コミュニティ
