AWS OpsWorks スタック CLI の使用 - AWS OpsWorks

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

AWS OpsWorks スタック CLI の使用

AWS OpsWorks スタックコマンドラインインターフェイス (CLI) は、コンソールと同等の機能を提供し、さまざまなタスクに使用できます。AWS OpsWorks スタック CLI は、AWS CLI の一部として提供されます。AWS CLI をインストールして設定する方法など、詳細については、「AWS コマンドラインインターフェイスについて」を参照してください。各コマンドの詳細な説明については、「AWS OpsWorks スタックリファレンス」を参照してください。

注記

Windows ベースのワークステーションを使用している場合は、AWSTools for Windows PowerShellAWS OpsWorksコマンドラインからオペレーションをスタックします。詳細については、「AWS Tools for Windows PowerShell」を参照してください。

AWS OpsWorks スタックコマンドの一般的な形式を次に示します。

aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]

引数値が JSON オブジェクトである場合は、" 文字をエスケープする必要があります。そうしないと、コマンドから JSON が有効でないというエラーが返されます。たとえば、JSON オブジェクトが "{"somekey":"somevalue"}" である場合は、"{\"somekey\":\"somevalue\"}" という形式にします。別のアプローチは、JSON オブジェクトをファイルに保存し、file:// を使用してコマンドラインでそのファイルを指定することです。以下の例では、appsource.json に保存されたアプリケーションソースオブジェクトを使用して、アプリケーションを作成しています。

aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json

ほとんどの場合、コマンドから JSON オブジェクトとしてパッケージ化された 1 つ以上の値が返されます。以下のセクションでは、いくつかの例を示します。各コマンドの戻り値の詳細については、「AWS OpsWorks スタックリファレンス」を参照してください。

注記

例に示すように、AWS CLI コマンドではリージョンを指定する必要があります。-- リージョンパラメータの有効値を次の表に示します。AWS OpsWorks スタックコマンド文字列を簡素化するには、CLI の設定でデフォルトのリージョンを指定することで、--region パラメータを省略できるようにします。複数のリージョンエンドポイントを通常使用する場合は、デフォルトのリージョンエンドポイントを使用するように AWS CLI を設定しないでください。カナダ (中部) リージョンエンドポイントは、API およびAWS CLIで作成したスタックでは使用できません。AWS Management Console。詳細については、「AWS リージョンの設定」を参照してください。

リージョン名 コマンドコード
米国東部 (オハイオ) リージョン us-east-2
米国東部 (バージニア北部) リージョン us-east-1
米国西部 (北カリフォルニア) リージョン us-west-1
米国西部 (オレゴン) リージョン us-west-2
カナダ (中部) リージョン ca-central-1
欧州 (アイルランド) リージョン eu-west-1
欧州 (ロンドン) リージョン eu-west-2
欧州 (パリ) リージョン eu-west-3
欧州 (フランクフルト) リージョン eu-central-1
アジアパシフィック (東京) リージョン ap-northeast-1
アジアパシフィック (ソウル) リージョン ap-northeast-2
アジアパシフィック (ムンバイ) リージョン ap-south-1
アジアパシフィック (シンガポール) リージョン ap-southeast-1
アジアパシフィック (シドニー) リージョン ap-southeast-2
南米 (サンパウロ) リージョン sa-east-1

CLI コマンドを使用するには、適切なアクセス許可が必要です。AWS OpsWorks スタックのアクセス権限の詳細については、「ユーザーアクセス許可の管理」を参照してください。特定のコマンドに必要なアクセス許可を調べるには、「AWS OpsWorks スタックリファレンス」のコマンドリファレンスのページを参照してください。

以下のセクションでは、AWS OpsWorks スタック CLI を使用してさまざまな一般タスクを実行する方法について説明します。