Oracle Linux Automation Manager CLIおよびAPIリファレンス・ガイド

コマンドライン・インタフェースの設定

この項では、Oracle Linux Automation Managerコマンドライン・インタフェースの設定について説明します。

タスク1: コマンドライン・インタフェースのインストール

コマンドライン・インタフェースは、Oracle Linux Automation Managerサーバーと同じシステム、またはOracle Linux Automation Managerサーバーに接続できる別のOracle Linux 8システムにインストールできます。

次の手順では、Oracle Linux 8システムを設定してOracle Linux Automation Managerコマンドライン・インタフェースをインストールする方法について説明します。

「Oracle Linux Automation Managerインストレーション・ガイド」の説明に従って、Oracle Linux Automation Managerサーバーを設定します。
Oracle Linux 8を実行している別のマシンでCLIを実行している場合は、「Oracle Linux Automation Managerインストレーション・ガイド」の説明に従ってDNFリポジトリまたはULNチャネルを有効にします。
Oracle Linux Automation Managerサーバーを実行している同じマシンまたは別のマシンに、ol-automation-manager-cliパッケージをインストールします。
```
sudo dnf install ol-automation-manager-cli
```
使用しているマシンがOracle Linux Automation Managerで設定されているポートにアクセスできることを確認します。

タスク2: コマンドライン・インタフェース・コマンドの実行

コマンドライン・インタフェース・コマンドを実行し、1つ以上のコマンドライン・オプションを指定します。たとえば、

コマンドライン・インタフェースを使用するユーザー・アカウントの認証トークンを取得します。トークン認証の取得の詳細は、認証を参照してください。

システムのターミナルから、次の構文を使用します。

awx --conf.host https://<hostname or IP address> --conf.token <access_token> <resource> <action> <optional_arguments> <input/output formatting>

前の構文では、

<hostname or IP address>は、Oracle Linux Automation Managerサーバーのホスト名またはIPアドレスです。
<access_token>は、Oauth2トークンです。
<resource>は、アクションを実行するリソースです。
<action>は、リソースに対して実行するアクションです。
<optional_arguments>は、アクションに指定するその他のオプションです。
<input/output formatting>は、レスポンスに適用する追加の書式設定オプションです

これらのパラメータの詳細は、コマンド・ライン・インタフェースの使用を参照してください。

たとえば、次のコマンドは、Oracle Linux Automation Managerサーバーで構成されているすべてのユーザーをリストします。

awx --conf.host https://192.102.118.107 --conf.token h7a3NPiam8Or4px7Kkoe87cWcTeixz users list
{
     "count": 3,
     "next": null,
     "previous": null,
     "results": [
          {
               "id": 1,
               "type": "user",
               "url": "/api/v2/users/1/",
               "related": {
                    "teams": "/api/v2/users/1/teams/",
                    "organizations": "/api/v2/users/1/organizations/",
                    "admin_of_organizations": "/api/v2/users/1/admin_of_organizations/",
                    "projects": "/api/v2/users/1/projects/",
                    "credentials": "/api/v2/users/1/credentials/",
                    "roles": "/api/v2/users/1/roles/",
                    "activity_stream": "/api/v2/users/1/activity_stream/",
                    "access_list": "/api/v2/users/1/access_list/",
                    "tokens": "/api/v2/users/1/tokens/",
                    "authorized_tokens": "/api/v2/users/1/authorized_tokens/",
                    "personal_tokens": "/api/v2/users/1/personal_tokens/"
               },
               "summary_fields": {
                    "user_capabilities": {
                         "edit": true,
                         "delete": false
                    }
               },
               "created": "2021-11-11T14:20:55.451086Z",
               "username": "admin",
....