Alibaba Cloud CLIは、Alibaba Cloud APIに基づいて開発された管理ツールです。 Alibaba Cloud CLIを使用すると、Cloud ShellでAlibaba Cloudリソースを迅速に管理できます。
始める前に
Cloud ShellインスタンスでAlibaba Cloud CLIを使用する前に、次の点に注意してください。
Alibaba Cloud CLIは、Alibaba Cloud APIに基づいて開発された管理ツールです。 詳細については、「Alibaba Cloud CLIとは」をご参照ください。
Alibaba Cloudアカウントとクラウド リソースのセキュリティを確保するために、Resource Access Management (RAM) ID (RAMユーザーまたはRAMロール)を使用してCloud Shellにアクセスすることをお勧めします。 RAM IDとしてCloud Shellにアクセスするには、必要な権限をRAM IDに付与する必要があります。 詳細については、「IDベースのポリシー」をご参照ください。
バージョンの同期に影響を与えるさまざまな要因により、Cloud ShellにプリインストールされているAlibaba Cloud CLIのバージョンは、通常、GitHubリポジトリでAlibaba Cloud CLIのバージョンがアップグレードされてから数日以内にアップグレードされます。
aliyun version
コマンドを実行して、Alibaba Cloud CLIの現在のバージョンを表示できます。 また、任意のバージョンのAlibaba Cloud CLIを手動でインストールすることもできます。
手順
ステップ 1:Cloud Shellを起動する
Cloud Shellを起動する前に、必要な権限を持つRAM IDを使用してAlibaba Cloudホームページにログオンする必要があります。 Cloud Shellは、ログオン アカウントのID情報に基づいて、IDクレデンシャルを自動的に構成します。 自動クレデンシャル構成機能が無効にならないように、初期構成ファイル default
を変更または削除しないことをお勧めします。
次のいずれかの方法を使用して、Cloud Shellを起動できます。
Alibaba Cloud管理コンソールでCloud Shellを起動する
Alibaba Cloud管理コンソールで、上部ナビゲーション バーのCloud Shellアイコンをクリックします。
スタンドアロン アプリケーションとしてCloud Shellを起動する
ブラウザのアドレス バーに https://shell.aliyun.comと入力します。
Cloud Shellに初めて接続すると、仮想マシン (VM)が作成されます。 作成プロセスには最大 30 秒かかります。
ビジネス要件に基づいて、複数のCloud Shellウィンドウを開くことができます。 同時に最大 5 つのCloud Shellウィンドウを開くことができます。 すべてのウィンドウは同じVMに接続されています。 新しいCloud Shellウィンドウを開いても、VMの数は増えません。
詳細については、「Cloud Shellとは」をご参照ください。
ステップ 2:CLIコマンドを取得する
CLIコマンドを自動的に生成する
OpenAPI Explorerを使用すると、Alibaba Cloud CLIのすべてのコマンドをオンラインで生成できます。 この方法を使用して、必要なサンプル コマンドを取得することをお勧めします。 詳細については、「コマンドの生成」をご参照ください。
デバッグ ページの左側の検索ボックスで、呼び出すAPIオペレーションを検索します。 APIオペレーションの[パラメーター] タブで、APIリファレンスに基づいてパラメーターを指定します。 右側の[CLIの例] タブをクリックして、指定したパラメーターを含む生成されたサンプル コマンドを表示します。
[cloudshellでコマンドを実行] (
アイコン)をクリックしてCloud Shellを起動し、Cloud Shellでコマンドをデバッグします。
[コピー] (
アイコン)をクリックしてサンプルCLIコマンドをクリップボードにコピーし、Cloud Shellに貼り付けてコマンドを実行します。
コマンドを手動で記述する
Alibaba Cloudは、RPC APIとRESTful APIを提供しています。 ほとんどのクラウド サービスは、Elastic Compute Service (ECS)、ApsaraDB RDS、Server Load Balancer (SLB)など、RPC APIを提供しています。
リクエスト メソッドは、呼び出すAPIのアーキテクチャ スタイルによって異なります。 次の説明に基づいてAPIタイプを判断できます。
APIで Action パラメーターが必要な場合は RPC APIです。 APIで PathPattern パラメーターが必要な場合は RESTful APIです。
通常、クラウド サービス内のすべてのAPIは同じタイプです。
詳細については、「コマンド構文」をご参照ください。
ヘルプ情報を取得する
Cloud Shellで次のコマンドを実行して、クラウド サービスに関するヘルプ情報を表示します。
aliyun <ProductCode> --help
たとえば、次のコマンドを実行して、ECS APIに関するヘルプ情報を表示します。
aliyun ecs --help
Cloud Shellで次のコマンドを実行して、APIオペレーションに関するヘルプ情報を表示します。
aliyun <ProductCode> <ApiName> --help
たとえば、次のコマンドを実行して、ECSの
DescribeInstanceAttribute
オペレーションに関するヘルプ情報を表示します。aliyun ecs DescribeInstanceAttribute --help
ステップ 3:Cloud Shellでコマンドを実行する
次の図に示すように、Cloud Shellで Elastic Compute Serviceの CreateInstance
コマンドを実行して、従量課金制のECSインスタンスを作成します。
関連情報